firestarter_save_address
Save a delivery address to the buyer's address book for reuse on future orders after a purchase or when the buyer requests it, with optional labeling and default setting.
Instructions
Save a delivery address to the buyer's address book for reuse on future orders. Use this after a purchase when the buyer gave a new address, or when they explicitly ask to save an address. Pass an optional label (e.g. 'Home', 'Office', 'Mom's house') — if omitted, a default label is assigned. Set is_default: true to make it the default shipping address for future orders. Returns the saved address id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | Postal / ZIP code | |
| city | Yes | City | |
| name | No | Recipient name | |
| label | No | Label for this address (e.g. 'Home', 'Office', 'Warehouse'). If omitted, a default label is assigned. | |
| phone | No | Phone number for delivery | |
| state | No | State / province / region | |
| country | No | ISO country code (e.g. US, PK, KE, NG). ALWAYS pass it when the buyer's country is known or named anywhere in the address — omitting it makes the API infer the country from the address text, falling back to US only as a last resort. | |
| street1 | Yes | Street address line 1 | |
| street2 | No | Street address line 2 (apt, suite, etc.) | |
| is_default | No | Set to true to make this the default shipping address. |