| Endpoint essentials | |
|---|---|
| API key access | api/v1/emailer_campaigns/activity_feed or Master API key |
| OAuth scopes | emailer_campaigns_activity_feed |
| Credit usage | 0 creditsLearn more about API pricing and credits. |
Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time.
Use the Get Contact Sequence Activity endpoint to retrieve one contact's sequence timeline: when they were added to a sequence, when their enrollment was paused, resumed, failed, finished, or removed, and when they replied. This is the same enrollment activity that the contact's timeline shows in Apollo.
You must provide a contact_id, and that contact must belong to your team. If it doesn't, or if the ID doesn't match a contact, Apollo returns a 404.
This endpoint returns activity for a single contact — it doesn't return activity for every contact in a sequence. By default it covers all of the contact's sequences; to narrow the timeline to one sequence, also provide a sequence_id. A sequence_id with no matching activity for this contact returns an empty events array rather than an error.
Events are returned newest-first, and each response contains at most 50 events. There is no page parameter, so per_page lowers the number of recent events returned rather than moving through pages of results.
To find contact IDs, call the Search for Contacts endpoint and identify the id value for the contact. To find sequence IDs, call the Search for Sequences endpoint and identify the id value for the sequence.
For replied events, the response includes the emailer_message_id of the email the contact replied to. Pass that ID to the Get Email Content endpoint to read the original email.