Resources

Contacts

A contact represents a person or organization in your workspace, customers, vendors, leads, partners, and more.

POST/v1/contacts

Create a contact

Creates a new contact in the workspace associated with your API key. The new contact will be assigned to the key's workspace and attributed to the admin user who created the key.

Body parameters

Name	Type	Description
first_namerequired	string	Contact first name. Required.
last_name	string	Contact last name.
email	string	Email address. Either email or phone must be provided.
phone	string	Phone number. Either email or phone must be provided.
company	string	Company name the contact belongs to.
job_title	string	Contact job title.
contact_type	enum	One of: Customer, Vendor, Supplier, Partner, Lead, Other.
mailing_street	string	Mailing address street.
mailing_city	string	Mailing address city.
mailing_state	string	Mailing address state.
mailing_zip	string	Mailing address ZIP / postal code.
mailing_country	string	Mailing address country.
billing_street	string	Billing address street.
billing_city	string	Billing address city.
billing_state	string	Billing address state.
billing_zip	string	Billing address ZIP / postal code.
billing_country	string	Billing address country.
tags	string[]	Array of tag strings.

Returns

On success, returns HTTP 201 Created with the full contact object, including id,company_id, and timestamps.

Request

curl -X POST https://www.coastlinecrm.com/api/v1/contacts \
  -H "Authorization: Bearer ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@example.com",
    "company": "Acme Inc.",
    "contact_type": "Lead",
    "tags": ["inbound", "2026-q2"]
  }'

Response

{
  "id": "4a3c9b6e-...",
  "company_id": "ac1f1e52-...",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "phone": null,
  "company": "Acme Inc.",
  "contact_type": "Lead",
  "tags": ["inbound", "2026-q2"],
  "created_at": "2026-04-17T14:22:08.412Z",
  "updated_at": "2026-04-17T14:22:08.412Z"
}