Reply.io
App · 32 actions
Run sales outreach in Reply.io: create and update contacts, add them to sequences and finish or pause them there, mark replies, manage tasks, templates, contact lists and do-not-contact rules, and read sequence results.
Actions
| Action | What it does |
|---|---|
| Add contacts to list | Put contacts on a contact list. |
| Add contacts to sequence | Enrol contacts in a sequence, now or from a time you choose. |
| Add do-not-contact rule | Stop Reply.io contacting an email address or a whole domain, or add an exception that is always allowed. |
| Add note to contact | Add a note to a contact's timeline so your team sees the context. |
| Complete task | Mark a task done. |
| Create contact | Add a contact to Reply.io. |
| Create contact list | Create an empty contact list. |
| Create email template | Save an email template you can use in sequences. |
| Create sequence | Create a sequence with one email step. |
| Create task | Create a task for yourself, such as a call or a to-do, linked to a contact. |
| Delete contact | Delete a contact from Reply.io for good. |
| Delete contact list | Delete a contact list. |
| Delete do-not-contact rule | Remove a rule so those contacts can be emailed again. |
| Delete email template | Delete an email template. |
| Delete sequence | Delete a sequence and take everyone out of it. |
| Delete task | Delete a task. |
| Find contacts | List contacts a page at a time, or look one up by exact email address or LinkedIn address. |
| Find sequences | List sequences a page at a time, by status or part of the name. |
| Get contact | Get one contact with their profile, owner, opt-out state and custom fields. |
| Get current user | Get the Reply.io user the API key acts as: their id, username and team id. |
| Get sequence | Get a sequence with its steps, settings and connected mailboxes. |
| Get sequence stats | Get a sequence's email and LinkedIn results (contacted, opened, replied, bounced and more) for a period. |
| List contact lists | List contact lists a page at a time, optionally by part of the name. |
| List contacts in sequence | List the contacts in a sequence with their status, current step and whether they replied or bounced. |
| List do-not-contact rules | List the email, domain or exception rules that stop Reply.io contacting people. |
| List email accounts | List the mailboxes connected to Reply.io with their daily limit and whether they are connected. |
| List email templates | List email templates a page at a time, optionally by part of the name. |
| List tasks | List tasks a page at a time, with their type, status, contact and due date. |
| Mark contacts as replied | Record a reply Reply.io did not see (in another inbox or a CRM). |
| Remove contact from sequence | Take one contact out of a sequence. |
| Set contact status in sequence | Finish, pause or resume contacts in one sequence. |
| Update contact | Change a contact's details. |
Add contacts to list
Put contacts on a contact list.
Inputs
- Contact list
list_idtextRequired - The contact list. Pick one, or give its id from an earlier step.
- Contact IDs
contact_idstextRequired - One contact id, several separated by commas, or a list from an earlier step. Up to 100.
Outputs
The add contacts to list result
addedlist- Ids of the contacts added
added_countnumber- How many were added
list_idnumber- The list they were added to
not_processedlist- Contacts Reply.io did not add, with why
not_processed_countnumber- How many were not added
Example output
{
"added": [
4821
],
"added_count": 1,
"list_id": 12,
"not_processed": [],
"not_processed_count": 0
}Add contacts to sequence
Enrol contacts in a sequence, now or from a time you choose. Contacts already in it, opted out or blocked are reported, not added.
Inputs
- Sequence
sequence_idtextRequired - The sequence. Pick one, or give its id from an earlier step.
- Contact IDs
contact_idstextRequired - One contact id, several separated by commas, or a list from an earlier step. Up to 100.
- Start at
start_atdate and time - When to begin contacting them. Leave empty to start straight away.
- Skip the first step's delay
skip_first_delaytrue/false - On sends the first step without waiting for its delay.Default:
false. - Move from their other sequences
remove_from_other_sequencestrue/false - On takes the contacts out of any sequence they are in first.Default:
false.
Outputs
The add contacts to sequence result
addedlist- Ids of the contacts added
added_countnumber- How many were added
not_processedlist- Contacts Reply.io did not add, with why
not_processed_countnumber- How many were not added
Example output
{
"added": [
4821
],
"added_count": 1,
"not_processed": [
{
"details": "Already in it",
"error": "alreadyInSequence",
"id": 4822
}
],
"not_processed_count": 1
}Add do-not-contact rule
Stop Reply.io contacting an email address or a whole domain, or add an exception that is always allowed.
Inputs
- Rule type
rule_typetextRequired - Which do-not-contact list: email addresses, domains or exceptions.One of:
email(Email address),domain,exception(Email exception (always allowed)). - Address or domain
patterntextRequired - The email address or domain, such as competitor.example.
Outputs
The add do-not-contact rule result
ruleobject- The new rule
Example output
{
"rule": {
"id": 63,
"isGlobal": false,
"pattern": "competitor.example"
}
}Add note to contact
Add a note to a contact's timeline so your team sees the context.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'Find contacts' or the step that created it.
- Note
notetextRequired - The note to add.
Outputs
The add note to contact result
addedtrue/false- Always true once added
contact_idnumber- The contact noted
notetext- The note added
Example output
{
"added": true,
"contact_id": 4821,
"note": "Asked for a demo."
}Complete task
Mark a task done. It can also finish the contact in the task's sequence.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or the step that created it.
- Also finish the contact in the sequence
finish_in_sequencetrue/false - On takes the contact out of the sequence the task came from.Default:
false.
Outputs
The complete task result
taskobject- The completed task
Example output
{
"task": {
"assignedUserId": 1234,
"contactId": 4821,
"createdAt": "2026-10-15T09:00:00Z",
"creationSource": "user",
"dueTo": "2026-10-17T09:00:00Z",
"finishedAt": "2026-10-17T10:00:00Z",
"id": 777,
"isScheduled": true,
"linkedInTaskType": "message",
"sequenceId": 200,
"startAt": "2026-10-16T09:00:00Z",
"status": "new",
"taskType": "toDo",
"template": {
"body": "Call about pricing",
"subject": "Pricing"
}
}
}Create contact
Add a contact to Reply.io. It needs an email address or a LinkedIn address.
Inputs
- Email
emailtext - The contact's email address. Give this or a LinkedIn address.
- First name
first_nametext - First name.
- Last name
last_nametext - Last name.
- Phone
phonetext - Phone number with the country code.
- Job title
titletext - Job title.
- Company
companytext - Company name.
- Company size
company_sizetext - Number of employees.One of:
Self-Employed,2-10(2 to 10),11-50(11 to 50),51-200(51 to 200),201-500(201 to 500),501-1000(501 to 1,000),1001-5000(1,001 to 5,000),5001-10000(5,001 to 10,000),10001+(More than 10,000). - Industry
industrytext - The company's industry.
- City
citytext - City.
- State
statetext - State or province.
- Country
countrytext - Country.
- LinkedIn address
linkedin_urltext - The contact's LinkedIn profile address. Give this or an email address.
- Notes
notestext - Free-text notes on the contact.
- Custom fields
custom_fieldsobject - Your own contact fields, each with its name and value, for example {"Lead source": "Webinar"}.
Outputs
The create contact result
contactobject- The new contact
Example output
{
"contact": {
"accountId": 55,
"addingDate": "2026-10-15T09:00:00Z",
"city": "Austin",
"company": "Acme",
"companySize": "51-200",
"country": "United States",
"createdAt": "2026-10-15T09:00:00Z",
"customFields": [
{
"enrichmentStatus": "none",
"key": "Lead source",
"value": "Webinar"
}
],
"domain": "example.com",
"email": "jo@example.com",
"firstName": "Jo",
"id": 4821,
"industry": "Software",
"isOptedOut": false,
"lastModifiedAt": "2026-10-15T09:00:00Z",
"lastName": "Bloggs",
"linkedInUrl": "https://www.linkedin.com/in/jo-bloggs",
"notes": "Met at a conference.",
"ownerUserId": 1234,
"phone": "+15555550100",
"stage": "New",
"state": "Texas",
"timeZoneId": "America/Chicago",
"title": "Head of Sales"
}
}Create contact list
Create an empty contact list.
Inputs
- Name
nametextRequired - The list's name.
- Share with my team
sharedtrue/false - On lets your team see and use the list.Default:
false.
Outputs
The create contact list result
listobject- The new list
Example output
{
"list": {
"id": 12,
"isShared": false,
"name": "Webinar attendees"
}
}Create email template
Save an email template you can use in sequences.
Inputs
- Name
nametextRequired - The template's name.
- Subject
subjecttext - The email subject.
- Body
bodytextRequired - The email body. Variables like {{FirstName}} work.
- Who can use it
visible_totext - Keep it to yourself or share it with your team.One of:
personal(Only me (default)),team(My whole team). Default:personal.
Outputs
The create email template result
templateobject- The new template
Example output
{
"template": {
"body": "Hi {{FirstName}}",
"createdAt": "2026-10-01T09:00:00Z",
"folderId": 3,
"folderType": "personal",
"id": 88,
"name": "Intro",
"subject": "Quick question",
"updatedAt": "2026-10-02T09:00:00Z"
}
}Create sequence
Create a sequence with one email step. It is not started, so nothing is sent until you start it in Reply.io.
Inputs
- Name
nametextRequired - The sequence's name.
- Subject
subjecttextRequired - The first email's subject. Variables like {{FirstName}} work.
- Message
messagetextRequired - The first email's body. Variables like {{FirstName}} work.
- How the email goes out
send_modetext - Send it automatically, or make a task to send it by hand.One of:
automatic(Send automatically (default)),manual(Make a task to send it by hand). Default:automatic. - Sending mailboxes
email_account_idslist - The mailboxes the sequence sends from. Leave empty to choose in Reply.io.
Outputs
The create sequence result
sequenceobject- The new sequence
Example output
{
"sequence": {
"created": "2026-10-01T09:00:00Z",
"emailAccounts": [
{
"email": "jo@acme.example",
"id": 31
}
],
"health": "healthy",
"id": 200,
"isArchived": false,
"name": "Q4 outbound",
"ownerUserId": 1234,
"scheduleId": 7,
"settings": {
"emailsCountPerDay": 100
},
"status": "active",
"steps": [
{
"delayInMinutes": 0,
"executionMode": "automatic",
"id": 9001,
"type": "email",
"variants": [
{
"id": 5001,
"message": "Hi {{FirstName}}",
"subject": "Quick question"
}
]
}
]
}
}Create task
Create a task for yourself, such as a call or a to-do, linked to a contact. It starts now and is due in a day unless you set times.
Inputs
- Type
task_typetextRequired - What kind of task it is.One of:
toDo(To do),call,meeting,linkedIn,manualEmail(Email to send by hand),sms(Text message),whatsApp(WhatsApp message). - Details
bodytextRequired - What the task is. For an email task, the message.
- Subject
subjecttext - A subject, for email and LinkedIn tasks.
- Contact ID
contact_idtext - The contact the task is about. Needed to fill in {{variables}}.
- Starts
start_atdate and time - When the task becomes due to start. Defaults to now.
- Due
due_atdate and time - When it is due, after the start. Defaults to a day later.
- LinkedIn action
linkedin_task_typetext - Which LinkedIn action the task is.Only when Type is LinkedIn. One of:
message,connect(Connection request),inMail,viewProfile(View profile).
Outputs
The create task result
taskobject- The new task
Example output
{
"task": {
"assignedUserId": 1234,
"contactId": 4821,
"createdAt": "2026-10-15T09:00:00Z",
"creationSource": "user",
"dueTo": "2026-10-17T09:00:00Z",
"finishedAt": "2026-10-17T10:00:00Z",
"id": 777,
"isScheduled": true,
"linkedInTaskType": "message",
"sequenceId": 200,
"startAt": "2026-10-16T09:00:00Z",
"status": "new",
"taskType": "toDo",
"template": {
"body": "Call about pricing",
"subject": "Pricing"
}
}
}Delete contact
Delete a contact from Reply.io for good. They leave every sequence and list they were in.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'Find contacts' or the step that created it.
Outputs
The delete contact result
contact_idnumber- The contact deleted
deletedtrue/false- Always true once deleted
Example output
{
"contact_id": 4821,
"deleted": true
}Delete contact list
Delete a contact list. The contacts on it are kept.
Inputs
- Contact list
list_idtextRequired - The contact list. Pick one, or give its id from an earlier step.
Outputs
The delete contact list result
deletedtrue/false- Always true once deleted
list_idnumber- The list deleted
Example output
{
"deleted": true,
"list_id": 12
}Delete do-not-contact rule
Remove a rule so those contacts can be emailed again.
Inputs
- Rule type
rule_typetextRequired - Which do-not-contact list: email addresses, domains or exceptions.One of:
email(Email address),domain,exception(Email exception (always allowed)). - Rule ID
rule_idtextRequired - The rule's id, from 'List do-not-contact rules' or the step that added it.
Outputs
The delete do-not-contact rule result
deletedtrue/false- Always true once deleted
rule_idnumber- The rule deleted
Example output
{
"deleted": true,
"rule_id": 63
}Delete email template
Delete an email template. Sequences already using its text keep it.
Inputs
- Email template
template_idtextRequired - The template. Pick one, or give its id from an earlier step.
Outputs
The delete email template result
deletedtrue/false- Always true once deleted
template_idnumber- The template deleted
Example output
{
"deleted": true,
"template_id": 88
}Delete sequence
Delete a sequence and take everyone out of it. The contacts stay in Reply.io.
Inputs
- Sequence
sequence_idtextRequired - The sequence. Pick one, or give its id from an earlier step.
Outputs
The delete sequence result
deletedtrue/false- Always true once deleted
sequence_idnumber- The sequence deleted
Example output
{
"deleted": true,
"sequence_id": 200
}Delete task
Delete a task.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or the step that created it.
Outputs
The delete task result
deletedtrue/false- Always true once deleted
task_idnumber- The task deleted
Example output
{
"deleted": true,
"task_id": 777
}Find contacts
List contacts a page at a time, or look one up by exact email address or LinkedIn address.
Inputs
- Email
emailtext - Only the contact with this exact email address.
- LinkedIn address
linkedin_urltext - Only the contact with this exact LinkedIn profile address.
- Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The find contacts result
contactslist- The contacts
countnumber- How many came back on this page
has_moretrue/false- Whether another page follows
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
Example output
{
"contacts": [
{
"accountId": 55,
"addingDate": "2026-10-15T09:00:00Z",
"city": "Austin",
"company": "Acme",
"companySize": "51-200",
"country": "United States",
"createdAt": "2026-10-15T09:00:00Z",
"customFields": [
{
"enrichmentStatus": "none",
"key": "Lead source",
"value": "Webinar"
}
],
"domain": "example.com",
"email": "jo@example.com",
"firstName": "Jo",
"id": 4821,
"industry": "Software",
"isOptedOut": false,
"lastModifiedAt": "2026-10-15T09:00:00Z",
"lastName": "Bloggs",
"linkedInUrl": "https://www.linkedin.com/in/jo-bloggs",
"notes": "Met at a conference.",
"ownerUserId": 1234,
"phone": "+15555550100",
"stage": "New",
"state": "Texas",
"timeZoneId": "America/Chicago",
"title": "Head of Sales"
}
],
"count": 1,
"has_more": false,
"next_skip": 0
}Find sequences
List sequences a page at a time, by status or part of the name.
Inputs
- Status
statustext - Only sequences in this state.One of:
active,paused,new(Not started yet). - Name contains
nametext - Only sequences whose name contains this text.
- Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The find sequences result
countnumber- How many came back on this page
has_moretrue/false- Whether another page follows
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
sequenceslist- The sequences
Example output
{
"count": 1,
"has_more": false,
"next_skip": 0,
"sequences": [
{
"created": "2026-10-01T09:00:00Z",
"health": "healthy",
"id": 200,
"isArchived": false,
"name": "Q4 outbound",
"ownerUserId": 1234,
"status": "active"
}
]
}Get contact
Get one contact with their profile, owner, opt-out state and custom fields.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'Find contacts' or the step that created it.
Outputs
The get contact result
contactobject- The contact
Example output
{
"contact": {
"accountId": 55,
"addingDate": "2026-10-15T09:00:00Z",
"city": "Austin",
"company": "Acme",
"companySize": "51-200",
"country": "United States",
"createdAt": "2026-10-15T09:00:00Z",
"customFields": [
{
"enrichmentStatus": "none",
"key": "Lead source",
"value": "Webinar"
}
],
"domain": "example.com",
"email": "jo@example.com",
"firstName": "Jo",
"id": 4821,
"industry": "Software",
"isOptedOut": false,
"lastModifiedAt": "2026-10-15T09:00:00Z",
"lastName": "Bloggs",
"linkedInUrl": "https://www.linkedin.com/in/jo-bloggs",
"notes": "Met at a conference.",
"ownerUserId": 1234,
"phone": "+15555550100",
"stage": "New",
"state": "Texas",
"timeZoneId": "America/Chicago",
"title": "Head of Sales"
}
}Get current user
Get the Reply.io user the API key acts as: their id, username and team id. A quick way to check the connection.
Inputs
None.
Outputs
The get current user result
team_idnumber- The user's team id
user_idnumber- The user's id
usernametext- The user's username
Example output
{
"team_id": 100,
"user_id": 1234,
"username": "jo@acme.example"
}Get sequence
Get a sequence with its steps, settings and connected mailboxes.
Inputs
- Sequence
sequence_idtextRequired - The sequence. Pick one, or give its id from an earlier step.
Outputs
The get sequence result
sequenceobject- The sequence
Example output
{
"sequence": {
"created": "2026-10-01T09:00:00Z",
"emailAccounts": [
{
"email": "jo@acme.example",
"id": 31
}
],
"health": "healthy",
"id": 200,
"isArchived": false,
"name": "Q4 outbound",
"ownerUserId": 1234,
"scheduleId": 7,
"settings": {
"emailsCountPerDay": 100
},
"status": "active",
"steps": [
{
"delayInMinutes": 0,
"executionMode": "automatic",
"id": 9001,
"type": "email",
"variants": [
{
"id": 5001,
"message": "Hi {{FirstName}}",
"subject": "Quick question"
}
]
}
]
}
}Get sequence stats
Get a sequence's email and LinkedIn results (contacted, opened, replied, bounced and more) for a period. Reply.io limits how often this can be asked.
Inputs
- Sequence
sequence_idtextRequired - The sequence. Pick one, or give its id from an earlier step.
- Period
periodtext - A ready-made period. Last week if you give nothing.One of:
lastWeek(Last week (default)),lastMonth(Last month),lastYear(Last year),allTime(All time). - From
from_datedate - First day to count. Use instead of a period.
- To
to_datedate - Last day to count, included. Use with 'From'.
Outputs
The get sequence stats result
emailobject- Email results
linkedinobject- LinkedIn results
Example output
{
"email": {
"bounced": 2,
"contacted": 120,
"delivered": 118,
"opened": 64,
"replied": 9
},
"linkedin": {
"connectionsAccepted": 12,
"connectionsSent": 30,
"messagesSent": 10
}
}List contact lists
List contact lists a page at a time, optionally by part of the name.
Inputs
- Name contains
searchtext - Only lists whose name contains this text.
- Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The list contact lists result
countnumber- How many came back on this page
has_moretrue/false- Whether another page follows
listslist- The contact lists
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
Example output
{
"count": 1,
"has_more": false,
"lists": [
{
"id": 12,
"isShared": false,
"name": "Webinar attendees"
}
],
"next_skip": 0
}List contacts in sequence
List the contacts in a sequence with their status, current step and whether they replied or bounced.
Inputs
- Sequence
sequence_idtextRequired - The sequence. Pick one, or give its id from an earlier step.
- Sort by
sort_bytext - What to sort by. Newest first unless you say otherwise.One of:
addingDate(Date added),email,firstName(First name),lastName(Last name),company,statusInSequence(Status in the sequence). - Order
sort_directiontext - Which end to start from.One of:
desc(Newest or highest first (default)),asc(Oldest or lowest first). - Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The list contacts in sequence result
contactslist- The contacts in the sequence
countnumber- How many came back on this page
has_moretrue/false- Whether another page follows
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
Example output
{
"contacts": [
{
"addingDate": "2026-10-15T09:00:00Z",
"company": "Acme",
"contactId": 4821,
"currentStep": {
"displayName": "Step 1: Email",
"stepId": 9001
},
"email": "jo@example.com",
"emailAccountId": 31,
"emailDisposition": {
"isBounced": false,
"isReplied": false
},
"firstName": "Jo",
"isOptedOut": false,
"lastName": "Bloggs",
"sequenceId": 200,
"statusInSequence": "active",
"title": "Head of Sales"
}
],
"count": 1,
"has_more": false,
"next_skip": 0
}List do-not-contact rules
List the email, domain or exception rules that stop Reply.io contacting people.
Inputs
- Rule type
rule_typetextRequired - Which do-not-contact list: email addresses, domains or exceptions.One of:
email(Email address),domain,exception(Email exception (always allowed)). - Contains
searchtext - Only rules whose pattern contains this text.
- Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The list do-not-contact rules result
countnumber- How many came back on this page
has_moretrue/false- Whether another page follows
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
ruleslist- The rules
Example output
{
"count": 1,
"has_more": false,
"next_skip": 0,
"rules": [
{
"id": 63,
"isGlobal": false,
"pattern": "competitor.example"
}
]
}List email accounts
List the mailboxes connected to Reply.io with their daily limit and whether they are connected.
Inputs
- Only my mailboxes
mine_onlytrue/false - On lists only mailboxes you own. Off lists every one you can see.Default:
false. - Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The list email accounts result
countnumber- How many came back on this page
email_accountslist- The mailboxes
has_moretrue/false- Whether another page follows
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
Example output
{
"count": 1,
"email_accounts": [
{
"connectionStatus": "connected",
"dailyLimit": 100,
"email": "jo@acme.example",
"emailAccountType": "gmail",
"id": 31,
"isDefault": true,
"ownerUserId": 1234,
"senderName": "Jo Bloggs",
"tags": [
"warm"
]
}
],
"has_more": false,
"next_skip": 0
}List email templates
List email templates a page at a time, optionally by part of the name.
Inputs
- Name contains
nametext - Only templates whose name contains this text.
- Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The list email templates result
countnumber- How many came back on this page
has_moretrue/false- Whether another page follows
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
templateslist- The templates
Example output
{
"count": 1,
"has_more": false,
"next_skip": 0,
"templates": [
{
"body": "Hi {{FirstName}}",
"createdAt": "2026-10-01T09:00:00Z",
"folderId": 3,
"folderType": "personal",
"id": 88,
"name": "Intro",
"subject": "Quick question",
"updatedAt": "2026-10-02T09:00:00Z"
}
]
}List tasks
List tasks a page at a time, with their type, status, contact and due date.
Inputs
- Page size
limitnumber - How many to return, 1 to 1000. Reply.io's default is 25.From 1 to 1000.
- Skip
skipnumber - How many to skip, to get a later page. Use 'next_skip' from the last page.At least 0.
Outputs
The list tasks result
countnumber- How many came back on this page
has_moretrue/false- Whether another page follows
next_skipnumber- The 'Skip' to use to get the next page, 0 on the last
taskslist- The tasks
Example output
{
"count": 1,
"has_more": false,
"next_skip": 0,
"tasks": [
{
"assignedUserId": 1234,
"contactId": 4821,
"createdAt": "2026-10-15T09:00:00Z",
"creationSource": "user",
"dueTo": "2026-10-17T09:00:00Z",
"finishedAt": "2026-10-17T10:00:00Z",
"id": 777,
"isScheduled": true,
"linkedInTaskType": "message",
"sequenceId": 200,
"startAt": "2026-10-16T09:00:00Z",
"status": "new",
"taskType": "toDo",
"template": {
"body": "Call about pricing",
"subject": "Pricing"
}
}
]
}Mark contacts as replied
Record a reply Reply.io did not see (in another inbox or a CRM). It stops further steps for them. Name a sequence to do it for that sequence only, or leave it empty for every sequence they are in.
Inputs
- Contact IDs
contact_idstextRequired - One contact id, several separated by commas, or a list from an earlier step. Up to 100.
- Only in sequence
sequence_idtext - Limit this to one sequence. Leave empty to apply it to every sequence the contacts are in.
- Replied
repliedtrue/false - On marks them as replied. Off clears the replied flag.Default:
true.
Outputs
The mark contacts as replied result
not_processedlist- Contacts Reply.io did not change, with why
not_processed_countnumber- How many were not changed
repliedtrue/false- The state set
updatedlist- Ids of the contacts changed
updated_countnumber- How many were changed
Example output
{
"not_processed": [],
"not_processed_count": 0,
"replied": true,
"updated": [
4821
],
"updated_count": 1
}Remove contact from sequence
Take one contact out of a sequence. They are not deleted.
Inputs
- Sequence
sequence_idtextRequired - The sequence. Pick one, or give its id from an earlier step.
- Contact ID
contact_idtextRequired - The contact's id, from 'Find contacts' or the step that created it.
Outputs
The remove contact from sequence result
contact_idnumber- The contact removed
removedtrue/false- Always true once removed
sequence_idnumber- The sequence they left
Example output
{
"contact_id": 4821,
"removed": true,
"sequence_id": 200
}Set contact status in sequence
Finish, pause or resume contacts in one sequence. Finishing stops all further steps for them.
Inputs
- Sequence
sequence_idtextRequired - The sequence. Pick one, or give its id from an earlier step.
- Contact IDs
contact_idstextRequired - One contact id, several separated by commas, or a list from an earlier step. Up to 100.
- Status
statustextRequired - What to set them to.One of:
finished(Finished (stop the sequence for them)),paused,active(Active (resume)),outOfOffice(Out of office).
Outputs
The set contact status in sequence result
not_processedlist- Contacts Reply.io did not change, with why
not_processed_countnumber- How many were not changed
statustext- The status set
updatedlist- Ids of the contacts changed
updated_countnumber- How many were changed
Example output
{
"not_processed": [],
"not_processed_count": 0,
"status": "finished",
"updated": [
4821
],
"updated_count": 1
}Update contact
Change a contact's details. Only the fields you fill in change; the rest stay as they are.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'Find contacts' or the step that created it.
- Email
emailtext - The contact's email address. Leave empty to keep it.
- First name
first_nametext - First name. Leave empty to keep it.
- Last name
last_nametext - Last name. Leave empty to keep it.
- Phone
phonetext - Phone number with the country code. Leave empty to keep it.
- Job title
titletext - Job title. Leave empty to keep it.
- Company
companytext - Company name. Leave empty to keep it.
- Company size
company_sizetext - Number of employees. Leave empty to keep it.One of:
Self-Employed,2-10(2 to 10),11-50(11 to 50),51-200(51 to 200),201-500(201 to 500),501-1000(501 to 1,000),1001-5000(1,001 to 5,000),5001-10000(5,001 to 10,000),10001+(More than 10,000). - Industry
industrytext - The company's industry. Leave empty to keep it.
- City
citytext - City. Leave empty to keep it.
- State
statetext - State or province. Leave empty to keep it.
- Country
countrytext - Country. Leave empty to keep it.
- LinkedIn address
linkedin_urltext - The contact's LinkedIn profile address. Leave empty to keep it.
- Notes
notestext - Free-text notes on the contact. Leave empty to keep it.
- Opt-out
opt_outtext - Opt the contact out of all emails, or clear their opt-out. Leave empty to leave it as it is.One of:
opt_out(Opt the contact out of all emails),clear(Clear the opt-out). - Custom fields
custom_fieldsobject - Your own contact fields, each with its name and value, for example {"Lead source": "Webinar"}.
Outputs
The update contact result
contactobject- The updated contact
Example output
{
"contact": {
"accountId": 55,
"addingDate": "2026-10-15T09:00:00Z",
"city": "Austin",
"company": "Acme",
"companySize": "51-200",
"country": "United States",
"createdAt": "2026-10-15T09:00:00Z",
"customFields": [
{
"enrichmentStatus": "none",
"key": "Lead source",
"value": "Webinar"
}
],
"domain": "example.com",
"email": "jo@example.com",
"firstName": "Jo",
"id": 4821,
"industry": "Software",
"isOptedOut": false,
"lastModifiedAt": "2026-10-15T09:00:00Z",
"lastName": "Bloggs",
"linkedInUrl": "https://www.linkedin.com/in/jo-bloggs",
"notes": "Met at a conference.",
"ownerUserId": 1234,
"phone": "+15555550100",
"stage": "New",
"state": "Texas",
"timeZoneId": "America/Chicago",
"title": "Head of Sales"
}
}