curl --request POST \
  --url https://api.heylibby.com/api/v1/campaigns/{campaignId}/contacts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "contacts": [
    {
      "firstName": "Ava",
      "lastName": "Lopez",
      "email": "ava@example.com",
      "phone": "15551234567",
      "contactMetadata": {
        "source": "web_form",
        "tier": "trial"
      }
    }
  ]
}'

{
  "message": "Processed 3 contacts successfully",
  "success": [
    {
      "phone": "15551234567",
      "email": "jane.doe@example.com",
      "action": "created"
    },
    {
      "phone": "15559876543",
      "email": "john.smith@example.com",
      "action": "updated"
    }
  ],
  "errors": []
}

Campaigns

Manage campaign contacts

Creates or updates contacts in a campaign, or removes specific contacts when requested.

Usage scenarios

Create a new contact: Use the CreateNewContact example. Provide at least email or phone.
Update an existing contact: Use the UpdateExistingContact example. You can include any fields; unchanged fields will remain the same.
Remove a contact: Use the RemoveContact example. Set the top-level action field to "remove" and provide at least email or phone for each contact to remove.

Key fields

action: Set to "remove" to remove the contacts specified in the request. Omit this field to create or update contacts.
status: Use completed or disqualified to stop further outreach from campaigns. Other status values are allowed but won’t affect campaign behavior.
contactMetadata: Add any key:value pairs to inform your AI assistant’s behavior. For example, if you set "tier": "pro", you can configure your AI to skip contacts already in the pro tier, effectively disqualifying them from the campaign.

POST

campaigns

{campaignId}

contacts

curl --request POST \
  --url https://api.heylibby.com/api/v1/campaigns/{campaignId}/contacts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "contacts": [
    {
      "firstName": "Ava",
      "lastName": "Lopez",
      "email": "ava@example.com",
      "phone": "15551234567",
      "contactMetadata": {
        "source": "web_form",
        "tier": "trial"
      }
    }
  ]
}'

{
  "message": "Processed 3 contacts successfully",
  "success": [
    {
      "phone": "15551234567",
      "email": "jane.doe@example.com",
      "action": "created"
    },
    {
      "phone": "15559876543",
      "email": "john.smith@example.com",
      "action": "updated"
    }
  ],
  "errors": []
}

Authorizations

x-api-key

string

header

required

Path Parameters

campaignId

string<uuid>

required

The unique ID of the campaign

Body

application/json

contacts

object[]

required

List of contacts to add or update. When action is set to "remove", these contacts are removed from the campaign.

Show child attributes

action

enum<string>

Set to "remove" to remove the contacts specified in the contacts array.

Available options:

remove

Example:

"remove"

Response

Request accepted and processed successfully.

message

string

Human-readable summary of the operation results.

Example:

"Processed 2 contacts successfully, 1 failed"

success

object[]

Contacts that were successfully created, updated, or deleted.

Show child attributes

errors

object[]

Contacts that failed to process with error details.

Show child attributes

Outbound Phone Calling API

⌘I

Outbound Calling

Campaign Service API

Manage campaign contacts

Authorizations

Path Parameters

Body

Response