---
updatedAt: 2025-09-24T00:27:31.000Z
agentTools:
  projectIndex: https://docs.whippy.ai/llms.txt
---

# Add Contacts to a Sequence

```python Python
import requests

headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "X-WHIPPY-KEY": "API_KEY"
}

sequence_id = "sequence_uuid"
url = f'https://api.whippy.co/v1/sequences/{sequence_id}/contacts"

payload = {
    "from": "+14155552672",
    "step_id": "5cabf0d3-6e12-41f0-a53c-e80624e3d955"
    "schedule_at": "2023-08-16T22:51:59.649562Z",
    "to": [
        {
            "email": "space.invader@example.com",
            "phone": "+14155552671",
            "name": "Space Invader"
        }
    ],
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

```json Response Example
{
  "data": {
    "message": "Sequence contacts are being processed"
  }
}
```

# Add your API Key

<!-- python@6 -->

Create an API Key from the Whippy Dashboard. Paste your API Key into your code.

# Define your Sequence ID

<!-- python@9,10 -->

Take your sequence ID from the Whippy dashboard or use the list sequences endpoint to find the appropriate sequence

# Build your Seqeunce Params

<!-- python@12,13,14 -->

In order to add contact to a sequence you need to provide a valid channel phone number in E164 format that the sequence messages will be sent from.

You can optionally provide the sequence step id that you would like to add the contacts to. If you don't provide a sequence step id then the contacts will be added to the first step of the sequence. 

You can also optionally add the schedule_at parameter, which dictates at what time in the future the contacts will be added to the sequence.

# Add your Contacts List

<!-- python@15,16,17,18,19,20,21 -->

Before you can make a request, you need to tell us who you want to add to the sequence. To do this you can provide an array of contact objects. The only required field is the contact's "phone", but other fields are supported also.