Sequences are automated email courses that deliver content to subscribers over time. They help you nurture leads and deliver value through a series of scheduled emails.

Sequences were formerly referred to as Courses. API V3 retains the previous naming conventions, but will accept requests to sequences as the endpoint as well.

​
List sequences

Returns a list of sequences for your account.

​
Endpoint

GET /v3/sequences

​
Parameters

​
api_key
string
required

Your account API key

curl https://api.convertkit.com/v3/sequences?api_key=<your_public_api_key>

​
Add subscriber to a sequence

Subscribe an email address to one of your sequences.

​
Endpoint

POST /v3/sequences/#{sequence_id}/subscribe

​
Parameters

​
api_key
string
required

Your account API key

​
sequence_id
integer
required

The ID of the sequence you want to subscribe to

​
email
string
required

Subscriber email address

​
first_name
string

Subscriber first name

​
fields
object

Object of key/value pairs for custom field(s). The custom field(s) must exist before you can use it here.

​
tags
array

Array of tag ids to subscribe to

​
Deprecated Parameters

​
courses
array

Array of sequence ids to subscribe to. You should add the subscriber to each course individually.

​
forms
array

Array of form ids to subscribe to. You should add the subscriber to the form directly.

​
name
string

Subscriber first name. You should prefer using first_name listed above.

curl -X POST https://api.convertkit.com/v3/sequences/<sequence_id>/subscribe\
     -H "Content-Type: application/json; charset=utf-8"\
     -d '{ 
            "api_key": "<your_public_api_key>",
            "email": "[email protected]"
         }'

​
List subscriptions to a sequence

List subscriptions to a sequence including subscriber data.

​
Endpoint

GET /v3/sequences/#{sequence_id}/subscriptions

​
Parameters

​
api_secret
string
required

Your API secret key

​
sequence_id
integer
required

The ID of the sequence you want to retrieve subscriptions for

​
sort_order
string

Sort order for results (asc or desc). asc to list subscribers added oldest to newest, desc to list subscribers added newest to oldest. Default is asc.

​
subscriber_state
string

Filter by subscriber state (active or cancelled). Receive only active subscribers or cancelled subscribers.

​
page
integer

The page of results being requested. Default value is 1. Each page of results will contain up to 50 subscriptions.

curl https://api.convertkit.com/v3/sequences/<sequence_id>/subscriptions?api_secret=<your_secret_api_key>

Sequences are automated email courses that deliver content to subscribers over time. They help you nurture leads and deliver value through a series of scheduled emails.

Sequences were formerly referred to as Courses. API V3 retains the previous naming conventions, but will accept requests to sequences as the endpoint as well.

​
List sequences

Returns a list of sequences for your account.

​
Endpoint

GET /v3/sequences

​
Parameters

​
api_key
string
required

Your account API key

curl https://api.convertkit.com/v3/sequences?api_key=<your_public_api_key>

​
Add subscriber to a sequence

Subscribe an email address to one of your sequences.

​
Endpoint

POST /v3/sequences/#{sequence_id}/subscribe

​
Parameters

​
api_key
string
required

Your account API key

​
sequence_id
integer
required

The ID of the sequence you want to subscribe to

​
email
string
required

Subscriber email address

​
first_name
string

Subscriber first name

​
fields
object

Object of key/value pairs for custom field(s). The custom field(s) must exist before you can use it here.

​
tags
array

Array of tag ids to subscribe to

​
Deprecated Parameters

​
courses
array

Array of sequence ids to subscribe to. You should add the subscriber to each course individually.

​
forms
array

Array of form ids to subscribe to. You should add the subscriber to the form directly.

​
name
string

Subscriber first name. You should prefer using first_name listed above.

curl -X POST https://api.convertkit.com/v3/sequences/<sequence_id>/subscribe\
     -H "Content-Type: application/json; charset=utf-8"\
     -d '{ 
            "api_key": "<your_public_api_key>",
            "email": "[email protected]"
         }'

​
List subscriptions to a sequence

List subscriptions to a sequence including subscriber data.

​
Endpoint

GET /v3/sequences/#{sequence_id}/subscriptions

​
Parameters

​
api_secret
string
required

Your API secret key

​
sequence_id
integer
required

The ID of the sequence you want to retrieve subscriptions for

​
sort_order
string

Sort order for results (asc or desc). asc to list subscribers added oldest to newest, desc to list subscribers added newest to oldest. Default is asc.

​
subscriber_state
string

Filter by subscriber state (active or cancelled). Receive only active subscribers or cancelled subscribers.

​
page
integer

The page of results being requested. Default value is 1. Each page of results will contain up to 50 subscriptions.

curl https://api.convertkit.com/v3/sequences/<sequence_id>/subscriptions?api_secret=<your_secret_api_key>