Add contact to audience
Add a contact to an audience. If a contact with the same email already exists in the workspace it is reused; otherwise a new contact is created. Requires contacts:write scope.
Authorization
bearerAuth Bearer token authentication. Use a Regular API key for email sending, or an Admin API key for marketing and automation endpoints.
Get your API keys from Settings → API Keys (regular) or Settings → Admin API Keys (admin) in the dashboard.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.keplars.com/api/v1/public/contacts/add-contact" \ -H "Content-Type: application/json" \ -d '{ "email": "[email protected]", "audience_id": "875075bb-caff-4035-8f5f-9fb1430dc417" }'{
"success": true,
"message": "Success",
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}Send instant email POST
Highest priority queue. Designed for **2FA codes, OTPs, and password resets** where sub-5-second delivery is critical. Processing time: 0–5 seconds. Retries: 5. Do not use for bulk marketing sends.
Delete contact DELETE
Permanently removes a contact from your workspace. Requires `contacts:write` scope.