Campaigns steps create

POST /api/v1/public/campaigns//steps/

Adds a new step to a campaign. Cannot add steps to active campaigns. Auth: X-API-Key

Path Parameters

id (integer, required): Campaign ID

Request Body

{
  "step_type": "EMAIL",
  "message_template": "Hi {{first_name}}, I hope you're doing well!",
  "subject_line": "Quick question about {{company_name}}",
  "delay_in_hours": 24,
  "subject_line_b": "Alternative subject for {{first_name}}",
  "message_template_b": "Alternative message for {{first_name}}",
  "add_unsubscribe": true,
  "parent_step_id": 123,
  "child_step_id": 456
}

Flow Management Fields

parent_step_id (integer, optional): ID of the step that comes before this one
parent_condition_id (integer, optional): ID of the condition that comes before this one
child_step_id (integer, optional): ID of the step that comes after this one
child_condition_id (integer, optional): ID of the condition that comes after this one

Note: You can only specify one parent (either parent_step_id OR parent_condition_id) and one child (either child_step_id OR child_condition_id).

Available Step Types

EMAIL: Send an email
LINKEDIN_MESSAGE: Send a LinkedIn message
LINKEDIN_INVITE: Send a LinkedIn connection request
INMAIL: Send a LinkedIn InMail
VISIT_LINKEDIN_PROFILE: Visit a LinkedIn profile
DELETE_LINKEDIN_INVITE: Delete a LinkedIn connection request
LIKE_LAST_LINKEDIN_POST: Like the prospect’s last LinkedIn post

Available Variables

You can use these variables in message templates and subject lines with double brackets {{}}:

{{first_name}} - Prospect’s first name
{{last_name}} - Prospect’s last name
{{job_title}} - Job title
{{company_name}} - Company name
{{location}} - Location

Response

{
  "success": true,
  "step": {
    "id": 456,
    "step_type": "EMAIL",
    "subject_line": "Quick question about {{company_name}}",
    "message_template": "Hi {{first_name}}, I hope you're doing well!",
    "subject_line_b": "Alternative subject for {{first_name}}",
    "message_template_b": "Alternative message for {{first_name}}",
    "delay_in_hours": 24,
    "add_unsubscribe": true,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  },
  "campaign": {...}
}

Example

curl -X POST -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "step_type": "EMAIL",
    "message_template": "Hi {{first_name}}, I hope you are doing well!",
    "subject_line": "Quick question about {{company_name}}",
    "delay_in_hours": 24
  }' \
  "https://api.seleqt.ai/api/v1/public/campaigns/123/steps/"

Building a Campaign Flow

Here’s an example of how to build a complete campaign flow:

1. Create the first step (LinkedIn invite)

curl -X POST -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "step_type": "LINKEDIN_INVITE",
    "message_template": "Hi {{first_name}}, I would love to connect!",
    "delay_in_hours": 0
  }' \
  "https://api.seleqt.ai/api/v1/public/campaigns/123/steps/"

2. Create a follow-up email step

curl -X POST -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "step_type": "EMAIL",
    "message_template": "Hi {{first_name}}, I hope you are doing well!",
    "subject_line": "Quick question about {{company_name}}",
    "delay_in_hours": 24,
    "parent_step_id": 456
  }' \
  "https://api.seleqt.ai/api/v1/public/campaigns/123/steps/"

3. Create a final LinkedIn message

curl -X POST -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "step_type": "LINKEDIN_MESSAGE",
    "message_template": "Thanks for connecting {{first_name}}! I would love to discuss how we can help {{company_name}}.",
    "delay_in_hours": 48,
    "parent_step_id": 789
  }' \
  "https://api.seleqt.ai/api/v1/public/campaigns/123/steps/"

This creates a flow: LinkedIn Invite → Email (24h delay) → LinkedIn Message (48h delay)

Getting Started

API Reference

Public API

Webhooks

Campaigns steps create

POST /api/v1/public/campaigns//steps/

Path Parameters

Request Body

Flow Management Fields

Available Step Types

Available Variables

Response

Example

Building a Campaign Flow

1. Create the first step (LinkedIn invite)

2. Create a follow-up email step

3. Create a final LinkedIn message

​POST /api/v1/public/campaigns//steps/

​Path Parameters

​Request Body

​Flow Management Fields

​Available Step Types

​Available Variables

​Response

​Example

​Building a Campaign Flow

​1. Create the first step (LinkedIn invite)

​2. Create a follow-up email step

​3. Create a final LinkedIn message

POST /api/v1/public/campaigns//steps/

Path Parameters

Request Body

Flow Management Fields

Available Step Types

Available Variables

Response

Example

Building a Campaign Flow

1. Create the first step (LinkedIn invite)

2. Create a follow-up email step

3. Create a final LinkedIn message