external_contact_id, name, first_name, and last_name. The external_contact_id links the Shilo contact record back to your CRM or data source. All other fields are optional and can be populated now or updated later. This endpoint requires a write-enabled API key — read-only keys will receive a 403 response.
Endpoint
Authentication
Include your write-enabled API key in the request header:Request Body
string
required
Your system’s unique identifier for this contact. Used to correlate the Shilo record with your CRM or external data source.
string
required
Full display name of the contact (e.g.
"Jamie Customer").string
required
Contact’s first name.
string
required
Contact’s last name.
string
Primary phone number for the contact. Any standard formatting is accepted.
string[]
One or more email addresses to associate with this contact.
string
Human-readable label for the contact’s current pipeline stage (e.g.
"Negotiation").string
Your system’s ID for the pipeline stage. Useful for programmatic stage filtering later.
string
Human-readable label for the contact’s lead source (e.g.
"Zillow").string
Your system’s ID for the lead source.
string[]
An array of tag labels to apply to the contact for segmentation and filtering.
Response
A successful request returns HTTP201 with the newly created Contact object.
Response Fields
string
The Shilo-assigned UUID for the newly created contact.
string
The external ID you supplied at creation.
string
Full display name of the contact.
string
Contact’s first name.
string
Contact’s last name.
string
Primary phone number.
array of strings
Email addresses associated with the contact.
string
Pipeline stage label.
string
Pipeline stage ID from your system.
string
Lead source label.
string
Lead source ID from your system.
array of strings
Tags applied to the contact.
string
ISO-8601 timestamp indicating when this contact was created in Shilo.