POST /v1/contacts — create a contact record

The Create Contact endpoint adds a new contact record to your CharityStack account. firstName and lastName are required; all other fields are optional. Email uniqueness is enforced per organization — if an email in the request already belongs to another of your contacts, the request returns 409 email_taken with the existing contact’s ID.

Endpoint

POST https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/contacts

Authentication

string

required

Bearer token using your API key. Format: Bearer cs_live_your_key

Request body

string

required

Contact’s first name. Non-blank.

string

required

Contact’s last name. Non-blank.

string

Organization or company the contact belongs to.

object[]

Email entries. Duplicates (case-insensitive) are rejected.

Show email entry

string

required

The email address.

boolean

Exactly one entry may be primary; when none is marked, the first becomes primary.

object[]

Phone entries. Values are normalized to E.164 (e.g. +34613628904); bare national numbers are treated as US. Unparseable numbers return 400.

Show phone entry

string

required

The phone number.

boolean

Exactly one entry may be primary.

object[]

Address entries.

Show address entry

string

Street line 1.

string

Street line 2.

string

City.

string

State / region.

string

Postal code.

string

Country.

boolean

Exactly one entry may be primary.

SUBSCRIBED or UNSUBSCRIBED. Omit to use the creation default: SUBSCRIBED (email is an opt-out regime).

SUBSCRIBED or UNSUBSCRIBED. Omit to use the creation default: NEVER_SUBSCRIBED (SMS is an opt-in regime — only set SUBSCRIBED when you have collected explicit SMS consent).

Response

On success returns 201 with the created contact:

object

required

The full created contact record, in the same shape as Get Contact — including its generated id.

Errors

Status	Code	Meaning
400	`validation_failed`	Missing/blank name, unknown field, invalid email/phone, duplicate entries, or more than one primary.
401	—	Missing or invalid API key.
409	`email_taken`	An email in the request already belongs to another of your contacts. The response includes `existingContactID`.

Example

curl -X POST https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/contacts \
  -H "Authorization: Bearer cs_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Ali",
    "lastName": "Ahmed",
    "emails": [{"email": "ali@example.com", "is_primary": true}],
    "phones": [{"value": "+34613628904"}]
  }'

Successful creates emit the contact.created webhook event.

Organization

Payments

Subscriptions

Contacts

Forms

Prefilled-Checkout Links

Webhooks

Analytics

POST /v1/contacts — create a contact record

Endpoint

Authentication

Request body

Response

Errors

Example

​Endpoint

​Authentication

​Request body

​Response

​Errors

​Example

Endpoint

Authentication

Request body

Response

Errors

Example