Contacts

Create or update contacts

Upserts a single contact OR a batch ({ contacts: [...] }, up to 1000 rows). Unknown custom fields auto-create field definitions on the brand.

Single: 201 with { contact, created, fieldsCreated, warnings }. Batch: 200 with { summary, fieldsCreated, errors, warnings } — or 207 when some rows failed (per-row errors in errors[]).

post/v1/contacts

Request

Base URL
https://brew.new/api
Auth
- HTTP bearer
- or API key in header X-API-Key
TypeScript
https://skmtc.dev/brew/apis/brew-public-api-v1/docs/v1/contacts/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

Idempotency-Keystring

Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.

Request body

Response

Batch upsert applied (every row succeeded).

fieldsCreatedstring[] required

validationJobIdstring

Changes

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