VocalLabs icon

VocalLabs

Interact with VocalLabs AI Voice Calling API

Actions90

Contact → Add Multiple Contacts V2

AI-generated

Summary

Add multiple contacts to a specified prospect group using the VocalLabs V2 API by providing the user ID and a JSON array of contacts with their names, phone numbers (prefixed with '+'), and optional data properties.

Inputs

  • Prospect Group ID (required) — ID of the prospect group to which the contacts will be added. Obtain this from the "Get Contact Groups" operation.
  • User ID (required) — Your VocalLabs User ID, used for authentication and identifying the client.
  • Contacts (JSON) (required) — A JSON array of contact objects to add to the group. Each contact object must contain: 'name' (string), 'phone' (string starting with '+'), and optionally 'data' (object) with additional contact information.

Output shape

a single JSON object

The output object includes a 'success' boolean, the count of contacts added ('contacts_added'), an array ('contacts') summarizing the added contacts with their name, phone, and group ID, and the full API response under 'api_response'. The operation expects valid JSON in 'Contacts (JSON)'; invalid JSON or missing required fields will result in an error.

Examples

Example 1: Add multiple contacts to a prospect group

Providing prospect_group_id as 'grp_12345', client_id as 'user_67890', and a JSON array of contacts [{"name":"John Doe","phone":"+911234567890","data":{"email":"john@example.com"}},{"name":"Jane Smith","phone":"+919876543210","data":{"company":"Acme Corp"}}]; the operation adds these contacts to the specified group and returns confirmation with details.

Links

Discussion