name
or a company
.Query Parameters
- city
- company
- The contact's company, church, or other organization. It will be printed beneath the name and above the street address.
- country
Leave the country blank if the contact is in the United States.
For non-US addresses, use the English name of the country (e.g. Germany rather than Deutschland). Place other elements of the address in the
city
,state
, andpostal_code
fields normally.For example, even though German addresses place the postal code before the city name, keep the city in the
city
field and the postal code in thepostal_code
field. Our software automatically reformats international addresses as needed when printing envelopes.- external_id
- Use this field to store your application's identifier for this contact.
- file_as
The name we should use when showing this contact in a list. It is usually in the format
LastName, FirstName
for individuals, or just the regular name for companies and churches.If the
file_as
parameter is not included, one will be generated automatically, based on the contact's name.- greeting
The name we should use in the first line of a mail-merged letter, usually following the word "Dear".
If the
greeting
parameter is not included, one will be generated automatically, based on the contact's name.- name
- The contact's full name, as it should appear on the first line of an envelope.
- postal_code
- state
- street
- The street address may contain multiple lines
Successful Response
Error Responses
- 400 contacts.missing_name
- The contact must have a
name
orcompany
. - 500 contacts.error_creating_record
- There was a database error on our end when creating the contact.