Kit
App · Email Marketing · 5 actions
Connect your Kit (formerly ConvertKit) account to grow and manage your email list: create subscribers, look them up, and tag them to trigger automations.
Actions
| Action | What it does |
|---|---|
| Create or update subscriber | Add a subscriber to your Kit account, or update the existing subscriber if the email address is already in use. |
| Create tag | Create a tag in your Kit account, or return the existing tag if one with the same name already exists. |
| Get subscriber | Look up a Kit subscriber by email address. |
| List tags | List the tags in your Kit account. |
| Tag a subscriber | Apply a tag to a subscriber (by email address) to segment them and trigger any automations attached to the tag. |
Create or update subscriber
Add a subscriber to your Kit account, or update the existing subscriber if the email address is already in use.
Inputs
- Email address
email_addresstextRequired - Email address of the subscriber.
- First name
first_nametext - First name of the subscriber.
- State
statetext - State to create the subscriber in. Defaults to 'active'.One of:
active,inactive. Default:active. - Fields
fieldsobject - Custom field values, keyed by the field's label (e.g. {"Last name": "Doe"}). Each custom field must already exist on your Kit account.
Outputs
subscriberobject- The created or updated subscriber
Example output
{
"subscriber": {
"created_at": "2024-10-01T12:00:00Z",
"email_address": "jane@example.com",
"fields": {},
"first_name": "Jane",
"id": "875403",
"state": "active"
}
}Create tag
Create a tag in your Kit account, or return the existing tag if one with the same name already exists.
Inputs
- Name
nametextRequired - Name of the tag to create.
Outputs
tagobject- The created or existing tag
Example output
{
"tag": {
"created_at": "2024-10-01T12:00:00Z",
"id": "99123",
"name": "Newsletter Lead"
}
}Get subscriber
Look up a Kit subscriber by email address.
Inputs
- Email address
email_addresstextRequired - Email address of the subscriber to look up.
Outputs
subscriberobject- The matching subscriber, or null if no subscriber has that email address
Example output
{
"subscriber": {
"created_at": "2024-10-01T12:00:00Z",
"email_address": "jane@example.com",
"fields": {},
"first_name": "Jane",
"id": "875403",
"state": "active"
}
}List tags
List the tags in your Kit account.
Inputs
None.
Outputs
tagslist- Tags in the account
Example output
{
"tags": [
{
"created_at": "2024-10-01T12:00:00Z",
"id": "99123",
"name": "Newsletter Lead"
}
]
}Tag a subscriber
Apply a tag to a subscriber (by email address) to segment them and trigger any automations attached to the tag.
Inputs
- Tag ID
tag_idtextRequired - ID of the tag to apply.
- Email address
email_addresstextRequired - Email address of the subscriber to tag.
Outputs
subscriberobject- The tagged subscriber
tag_idtext- ID of the tag that was applied
Example output
{
"subscriber": {
"created_at": "2024-10-01T12:00:00Z",
"email_address": "jane@example.com",
"fields": {},
"first_name": "Jane",
"id": "875403",
"state": "active"
},
"tag_id": "99123"
}