Create a billing address

Create a new user-scoped billing address. The address is owned by the authenticated user and appears in the GET /billing/addresses list.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request body for creating a billing address.

string
required

Address category: BUSINESS | FREELANCE | PRIVATE

length ≤ 32
length ≤ 32
string
required
string
required

Region or province. Required for every country — the provider rejects a billing address without one, so a create that omits it (or sends a blank string) fails with 422 BILLING_ADDRESS_REGION_REQUIRED and a field error on this field, before the provider is called. For Italy, send the two-letter province sigla. The field stays nullable in this schema for backward compatibility; it is enforced at the boundary, not by schema validation.

string
required
string
required

Certified email address for electronic invoicing. An Italian BUSINESS or FREELANCE address must carry this or sdiCode; without either, the create fails with 422 BILLING_ADDRESS_ELECTRONIC_INVOICE_REQUIRED. Not used outside Italy, and not required for a PRIVATE address.

Electronic-invoicing recipient code. Interchangeable with pec for an Italian BUSINESS or FREELANCE address: either one satisfies the requirement.

emailRecipients
array of strings
Emailrecipients
boolean
Defaults to false
boolean
Defaults to true
Responses

401

Missing, invalid, or expired authentication token

403

Provider refused the request (resolved deny)

502

Provider rejected the request

503

Billing address service is temporarily unavailable

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json