Articles on: API Documentation

Message Sequencing via the Super Send API

Message Sequencing via the Super Send API

Super Send’s API provides powerful tools to create and manage message sequences, enabling you to automate multi-step outreach campaigns. This guide explains how to work with sequences effectively through the API.



1. Creating a Sequence



A sequence is part of a campaign and consists of multiple steps such as email, LinkedIn, or Twitter actions. Use the POST method to create a new sequence.

Example Request:



curl -X POST https://api.supersend.io/v1/sequences \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
  "CampaignId": "your-campaign-id",
  "name": "Follow-Up Sequence",
  "steps": [
    {
      "type": "email",
      "delay": 1,
      "content": {
        "subject": "Quick follow-up",
        "body": "Hi {{firstname}}, just checking in on my last message."
      }
    },
    {
      "type": "linkedin",
      "delay": 3,
      "content": {
        "message": "Hi {{firstname}}, I sent you an email earlier and wanted to connect here as well."
      }
    }
  ]
}'


Required Fields:



CampaignId: The campaign to which the sequence belongs.
name: A descriptive name for the sequence.
steps: An array of steps with the following properties:

type: The type of step (e.g., email, linkedin, twitter).

delay: The number of days to wait before executing the step.

content: The content of the step (e.g., email subject and body, LinkedIn message).



2. Updating a Sequence



To modify an existing sequence, use the PUT method with the sequence’s unique ID.

Example Request:



curl -X PUT https://api.supersend.io/v1/sequences/<SEQUENCE_ID> \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
  "name": "Updated Sequence Name",
  "steps": [
    {
      "type": "email",
      "delay": 2,
      "content": {
        "subject": "New subject line",
        "body": "Updated email content here."
      }
    }
  ]
}'




3. Retrieving Sequences



You can retrieve all sequences or a specific sequence using the GET method.

Retrieve All Sequences:



curl -X GET https://api.supersend.io/v1/sequences \
-H "Authorization: Bearer <YOUR_API_KEY>"


Retrieve a Specific Sequence:



curl -X GET https://api.supersend.io/v1/sequences/<SEQUENCE_ID> \
-H "Authorization: Bearer <YOUR_API_KEY>"




4. Deleting a Sequence



To remove a sequence, send a DELETE request to the sequence’s endpoint.

Example Request:



curl -X DELETE https://api.supersend.io/v1/sequences/<SEQUENCE_ID> \
-H "Authorization: Bearer <YOUR_API_KEY>"



**5. Best Practices for Message Sequencing**



Design Clear Sequences:
Use descriptive names for sequences and steps to keep your campaigns organized.

Personalize Messages:
Include dynamic variables like {{first_name}} and {{company_name}} to tailor each message.

Set Appropriate Delays:
Space out steps strategically to avoid overwhelming your contacts.

Monitor Performance:
Use the Event Tracking API to analyze how contacts engage with your sequences.



By leveraging the Super Send API’s message sequencing capabilities, you can automate and personalize your outreach campaigns for maximum efficiency and impact.

Updated on: 22/01/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!