Contacts

Create a contact

Create one contact, or send { contacts: [...] } to create or update up to 500 at once. The single form returns 409 when the email already exists; the bulk form matches existing contacts by email and updates them. Supports firstName/lastName and first_name/last_name aliases for Resend compatibility.

post/v1/contacts

Request

  • Base URL: https://smtpfa.st/api
  • URL: https://smtpfa.st/api/v1/contacts
  • Auth: HTTP bearer

Request body

OR

Example request

{
  "email": "steve@example.com",
  "firstName": "Steve",
  "lastName": "Wozniak",
  "first_name": "Steve",
  "last_name": "Wozniak",
  "properties": {
    "company": "Acme",
    "plan": "pro"
  },
  "segment_ids": [
    "clx_segment123"
  ]
}

Response

Contact created. The bulk form returns the created and updated contacts as a list.

OR

Example response

{
  "object": "contact",
  "id": "clx_contact123"
}

Changes

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