Create a contact
POST/v1/public/lists/:listId/contacts
Creates a contact or reuses an existing one. The contact is looked up by email within your account: if a contact with this email already exists, it is reused and the name and phone from the request are ignored; otherwise a new contact is created. Adding to the list is idempotent (already a member is a no-op). Variables are applied in both cases. A duplicate email is never an error. The created flag in the response distinguishes the two outcomes.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Contact created successfully.
The request is invalid.
A valid Public API token is required.
The endpoint requires a scope that is not granted to the token.
The requested resource was not found.
The request is syntactically correct but cannot be processed.
The current API key exceeded the configured rate limit.
Response Headers
Number of seconds after which the request may be retried safely.
Internal server error.