Actions38
- Auth Actions
- Channel Actions
- Contact Actions
- Custom Status Actions
- Funnel Actions
- Message Actions
- Team Actions
- Template Actions
- User Actions
- Webhook Actions
Contact → Create
AI-generatedSummary
Create a Callbell contact using a phone number or platform identifier, integration source, and name. Optionally include assignment, tags, custom fields, channel, and bot status.
Inputs
- identifier (required) — Required phone number or platform identifier for the contact.
- sourceCreate (required) — Required integration source: Facebook, Instagram, Messenger, Telegram, Webchat, or WhatsApp. Defaults to WhatsApp.
- name (required) — Required full name of the contact.
- additionalFieldsCreate — Optional fields: assignedUser (collaborator email), teamUuid, channelUuid (omit to use the declared default channel), botStatus (bot_start or bot_end), customFields (a JSON object of custom field values), and tags (comma-separated text, split into an array with whitespace trimmed). Only non-empty values are sent; customFields must parse as valid JSON.
Output shape
One output item containing the Callbell API's JSON response for each input item.
The response is returned unchanged; the source does not specify its fields or unwrap a contact record. With Continue On Fail enabled, a failed item returns an object containing an error message; otherwise the operation throws.
Examples
Example 1: Create a new WhatsApp lead and assign it to a team
Set identifier to the lead's phone number, sourceCreate to whatsapp, name to the lead's full name, and add teamUuid plus tags such as sales,lead.