HEhellobonsai
Contacts

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.

post/public-api/v1/contacts

Request

  • Base URL
    https://app.hellobonsai.com
  • URL
    https://app.hellobonsai.com/public-api/v1/contacts
  • Auth
    • OAuth 2
      Authorization code: https://app.hellobonsai.com/oauth/authorize
      Token URL: https://app.hellobonsai.com/oauth/token
    • or HTTP bearer

Request body

Example request

{
  "contact": {
    "name": "Alex Johnson",
    "email": "alex@example.com",
    "job_title": "CTO",
    "phone_number": "+1-415-555-0100",
    "company_id": 42
  }
}

Response

The contact was created.

Example response

{
  "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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.