Create a contact

​

Adds a person to your CRM. name and email are required.

Pass company_id to link them to a company you already have, or leave it out for a contact who does not belong to one.

Body
required
application/json

Contact attributes, wrapped in a contact key.

  • contact
    Type: object
    required
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/public-api/v1/contacts
curl https://app.hellobonsai.com/public-api/v1/contacts \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "contact": {
    "name": "Alex Johnson",
    "email": "alex@example.com",
    "job_title": "CTO",
    "phone_number": "+1-415-555-0100",
    "company_id": 42
  }
}'

{
  "data": {
    "id": 7,
    "name": "Alex Johnson",
    "email": "alex@example.com",
    "job_title": "CTO",
    "phone_number": "+1-415-555-0100",
    "archived_at": "2026-04-14T09:12:04.000Z",
    "created_at": "2026-04-14T09:12:04.000Z",
    "company_ids": [
      42
    ],
    "default_company_id": 42,
    "url": "https://app.hellobonsai.com/contacts/7"
  },
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
  }
}

The contact was created.