WIwithallo
Contacts

Create Contact

Changed on

Deprecated. Use POST /v2/api/crm/people instead. This endpoint still responds, but it is no longer maintained and is not part of the current API reference.

Create a new contact in your Allo account. At least one phone number is required.

post/v1/api/contacts

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v1/api/contacts
  • Auth
    API key in header Authorization

Request body

namestring nullable

First name

last_namestring nullable

Last name

job_titlestring nullable

Job title

websitestring nullable

Website URL

emailsstring[] nullable

Email addresses

numbersstring[] required

Phone numbers (at least one required, E.164 format)

Example request

{
  "name": "John",
  "last_name": "Doe",
  "job_title": "CEO",
  "website": "https://acme.com",
  "emails": [
    "john@acme.com"
  ],
  "numbers": [
    "+15551234567"
  ]
}

Response

Contact created successfully

Example response

{
  "data": {
    "id": "cnt_abc123",
    "name": "John",
    "last_name": "Doe",
    "company": {
      "name": "Acme Corp",
      "id": "com_xyz789"
    },
    "job_title": "Manager",
    "status": "active",
    "numbers": [
      "+1234567890"
    ]
  }
}

Changes