--- title: "Create a contact" method: POST path: "/v1/contacts" tags: ["Contacts"] --- # Create a contact `POST /v1/contacts` Creates a contact for a specified account. Each account must have at least one contact before it can be saved. You can add a maximum of 2000 contacts to an account. ## Headers - `Idempotency-Key` string - `Accept-Encoding` string - `Content-Encoding` string - `Zuora-Entity-Ids` string - `Zuora-Org-Ids` string - `Zuora-Track-Id` string - `Zuora-Version` string ## Request body - POSTContactType — Container for custom fields of a Contact object. - `accountId` string — The ID of the account associated with the contact. **Note**: When creating a contact, you must specify `accountNumber`, `accountId`, or both in the request body. If both fields are specified, they must correspond to the same account. - `accountNumber` string — The number of the customer account associated with the contact. **Note**: When creating a contact, you must specify `accountNumber`, `accountId`, or both in the request body. If both fields are specified, they must correspond to the same account. - `address1` string — The first line of the contact's address, which is often a street address or business name. - `address2` string — The second line of the contact's address. - `asBillTo` boolean — Indicates whether the contact can be specified as a bill-to contact. This field is available only if you have turned on the Ship To Contact feature. You can turn on the feature through the self-service interface for Feature Management. - `asShipTo` boolean — Indicates whether the contact can be specified as a ship-to contact. This field is available only if you have turned on the Ship To Contact feature. You can turn on the feature through the self-service interface for Feature Management. - `asSoldTo` boolean — Indicates whether the contact can be specified as a sold-to contact. This field is available only if you have turned on the Ship To Contact feature. You can turn on the feature through the self-service interface for Feature Management. - `city` string — The city of the contact's address. - `contactDescription` string — A description for the contact. - `country` string — The country of the contact's address. Either a full name or an ISO code is supported. - `county` string — The county. May optionally be used by Zuora Tax to calculate county tax. - `fax` string — The contact's fax number. - `firstName` string, required — The contact's first name. - `homePhone` string — The contact's home phone number. - `lastName` string, required — The contact's last name. - `mobilePhone` string — The mobile phone number of the contact. - `nickname` string — A nickname for the contact. - `otherPhone` string — An additional phone number for the contact. - `otherPhoneType` 'Work' | 'Mobile' | 'Home' | 'Other' — The type of the additional phone number. - `personalEmail` string, email — The contact's personal email address. - `state` string — The state or province of the contact's address. Either a full name or an abbreviation code is supported. - `taxRegion` string — If using Zuora Tax, a region string as optionally defined in your tax rules. Not required. - `workEmail` string — The contact's business email address. - `workPhone` string — The contact's business phone number. - `zipCode` string — The zip code for the contact's address. ## Response `200` OK - ContactResponse — Container for custom fields of a Contact object. - `accountId` string — The ID of the account associated with the contact. - `accountNumber` string — The number of the customer account associated with the contact. - `address1` string — The first line of the contact's address, which is often a street address or business name. - `address2` string — The second line of the contact's address. - `asBillTo` boolean — Indicates whether the contact can be specified as a bill-to contact. This field is available only if you have turned on the Ship To Contact feature. You can turn on the feature through the self-service interface for Feature Management. - `asShipTo` boolean — Indicates whether the contact can be specified as a ship-to contact. This field is available only if you have turned on the Ship To Contact feature. You can turn on the feature through the self-service interface for Feature Management. - `asSoldTo` boolean — Indicates whether the contact can be specified as a sold-to contact. This field is available only if you have turned on the Ship To Contact feature. You can turn on the feature through the self-service interface for Feature Management. - `city` string — The city of the contact's address. - `contactDescription` string — A description for the contact. - `country` string — The full country name of the contact's address. - `county` string, nullable — The county. May optionally be used by Zuora Tax to calculate county tax. - `fax` string — The contact's fax number. - `firstName` string — The contact's first name. - `homePhone` string — The contact's home phone number. - `lastName` string — The contact's last name. - `mobilePhone` string — The mobile phone number of the contact. - `nickname` string — A nickname for the contact. - `otherPhone` string — An additional phone number for the contact. - `otherPhoneType` 'Work' | 'Mobile' | 'Home' | 'Other' — The type of the additional phone number. - `personalEmail` string — The contact's personal email address. - `state` string — The full state or province name of the contact's address. - `success` boolean — Returns `true` if the request was processed successfully. - `taxRegion` string — If using Zuora Tax, a region string as optionally defined in your tax rules. Not required. - `workEmail` string — The contact's business email address. - `workPhone` string — The contact's business phone number. - `zipCode` string — The zip code for the contact's address. ## Other responses - `500` — Internal Server Error - `4XX` — Request Errors --- [API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)