Create enrollment

cURL

curl --request POST \
  --url https://api.unifygtm.com/sequences/v1/enrollments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "mailbox_emails": [
    "jsmith@example.com"
  ],
  "allowed_concurrent_sequence_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.unifygtm.com/sequences/v1/enrollments"

payload = {
    "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "mailbox_emails": ["jsmith@example.com"],
    "allowed_concurrent_sequence_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    sequence_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    person_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    mailbox_emails: ['jsmith@example.com'],
    allowed_concurrent_sequence_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.unifygtm.com/sequences/v1/enrollments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unifygtm.com/sequences/v1/enrollments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sequence_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'person_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'mailbox_emails' => [
        'jsmith@example.com'
    ],
    'allowed_concurrent_sequence_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unifygtm.com/sequences/v1/enrollments"

	payload := strings.NewReader("{\n  \"sequence_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"person_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"mailbox_emails\": [\n    \"jsmith@example.com\"\n  ],\n  \"allowed_concurrent_sequence_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.unifygtm.com/sequences/v1/enrollments")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sequence_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"person_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"mailbox_emails\": [\n    \"jsmith@example.com\"\n  ],\n  \"allowed_concurrent_sequence_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.unifygtm.com/sequences/v1/enrollments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sequence_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"person_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"mailbox_emails\": [\n    \"jsmith@example.com\"\n  ],\n  \"allowed_concurrent_sequence_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "sequence": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "is_paused": true
  },
  "person": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "jsmith@example.com",
    "first_name": "<string>",
    "last_name": "<string>",
    "linkedin_url": "<string>"
  },
  "mailbox": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "jsmith@example.com",
    "display_name": "<string>",
    "is_paused": true,
    "is_unauthorized": true
  },
  "enrolled_by_play": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "reply_email_message": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "subject": "<string>",
    "classifications": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "category": "AUTOMATED"
      }
    ],
    "received_at": "2023-11-07T05:31:56Z"
  },
  "status": "DRAFT",
  "is_draft_approval_pending": true,
  "is_blocked": true,
  "is_bounced": true,
  "is_canceled": true,
  "is_excluded": true,
  "is_opted_out": true,
  "is_paused": true,
  "is_replied": true,
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z"
}

{
  "status": "bad_request",
  "errors": [
    {
      "code": "<string>",
      "path": [
        "<string>"
      ],
      "object_api_name": "<string>",
      "attribute_api_name": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "status": "unauthorized",
  "message": "<string>"
}

{
  "status": "not_found",
  "message": "<string>"
}

{
  "status": "conflict",
  "message": "<string>",
  "active_sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "active_enrollment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reason": "MANUAL_APPROVAL_REQUIRED",
  "active_enrollments": [
    {
      "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "enrollment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "DRAFT",
      "policy": "ALLOWED"
    }
  ],
  "blocking_sequence_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "unapproved_sequence_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}

{
  "status": "rate_limited",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

POST

sequences

enrollments

cURL

curl --request POST \
  --url https://api.unifygtm.com/sequences/v1/enrollments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "mailbox_emails": [
    "jsmith@example.com"
  ],
  "allowed_concurrent_sequence_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.unifygtm.com/sequences/v1/enrollments"

payload = {
    "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "mailbox_emails": ["jsmith@example.com"],
    "allowed_concurrent_sequence_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    sequence_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    person_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    mailbox_emails: ['jsmith@example.com'],
    allowed_concurrent_sequence_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.unifygtm.com/sequences/v1/enrollments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unifygtm.com/sequences/v1/enrollments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sequence_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'person_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'mailbox_emails' => [
        'jsmith@example.com'
    ],
    'allowed_concurrent_sequence_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unifygtm.com/sequences/v1/enrollments"

	payload := strings.NewReader("{\n  \"sequence_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"person_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"mailbox_emails\": [\n    \"jsmith@example.com\"\n  ],\n  \"allowed_concurrent_sequence_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.unifygtm.com/sequences/v1/enrollments")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sequence_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"person_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"mailbox_emails\": [\n    \"jsmith@example.com\"\n  ],\n  \"allowed_concurrent_sequence_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.unifygtm.com/sequences/v1/enrollments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sequence_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"person_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"mailbox_emails\": [\n    \"jsmith@example.com\"\n  ],\n  \"allowed_concurrent_sequence_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "sequence": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "is_paused": true
  },
  "person": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "jsmith@example.com",
    "first_name": "<string>",
    "last_name": "<string>",
    "linkedin_url": "<string>"
  },
  "mailbox": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "jsmith@example.com",
    "display_name": "<string>",
    "is_paused": true,
    "is_unauthorized": true
  },
  "enrolled_by_play": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "reply_email_message": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "subject": "<string>",
    "classifications": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "category": "AUTOMATED"
      }
    ],
    "received_at": "2023-11-07T05:31:56Z"
  },
  "status": "DRAFT",
  "is_draft_approval_pending": true,
  "is_blocked": true,
  "is_bounced": true,
  "is_canceled": true,
  "is_excluded": true,
  "is_opted_out": true,
  "is_paused": true,
  "is_replied": true,
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z"
}

{
  "status": "bad_request",
  "errors": [
    {
      "code": "<string>",
      "path": [
        "<string>"
      ],
      "object_api_name": "<string>",
      "attribute_api_name": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "status": "unauthorized",
  "message": "<string>"
}

{
  "status": "not_found",
  "message": "<string>"
}

{
  "status": "conflict",
  "message": "<string>",
  "active_sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "active_enrollment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reason": "MANUAL_APPROVAL_REQUIRED",
  "active_enrollments": [
    {
      "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "enrollment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "DRAFT",
      "policy": "ALLOWED"
    }
  ],
  "blocking_sequence_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "unapproved_sequence_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}

{
  "status": "rate_limited",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

Overview

Create an enrollment to add a person to a published template sequence. The sequence’s ruleset determines enrollment eligibility.

Examples

Use an existing person and a published template sequence. Set UNIFY_API_KEY to your API key, replace the example IDs, and use an eligible connected sending mailbox:

curl --request POST \
  --url "https://api.unifygtm.com/sequences/v1/enrollments" \
  --header "X-Api-Key: $UNIFY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sequence_id": "c14aae21-3073-4c5d-98ac-9a8458cd0f2b",
  "person_id": "bf3f4d5e-c995-496f-8774-5a1c58d05197",
  "mailbox_emails": [
    "rep@your-company.example"
  ]
}'

Creating an enrollment starts the sequence’s workflow, which can send emails and create tasks. Review the sequence, recipient, and sending mailbox before running the request. Save the returned enrollment ID to inspect or pause it later.

Handle enrollment conflicts

When active enrollments prevent a new enrollment, the API returns 409 Conflict. Inspect reason and active_enrollments; the response can also include blocking_sequence_ids or unapproved_sequence_ids. If user approval is required, present the active enrollments for review before retrying with allowed_concurrent_sequence_ids. Those IDs record the user’s approval. Enrollment must still satisfy the sequences’ simultaneous enrollment policies. Other eligibility failures return 400 Bad Request with a message explaining the cause. Examples include an unpublished sequence, ineligible mailboxes, opt-outs, exclusions, and re-enrollment restrictions. Resolve that cause before retrying. Agentic sequences use the workflow for generating drafts in Unify. This endpoint returns 400 Bad Request for an agentic sequence. After Unify generates the drafts, you can review and edit their copy with List enrollment steps and Update enrollment step, then start each enrollment with Approve enrollment.

Authorizations

x-api-key

string

header

required

Body

application/json

Request body for enrolling a person in a sequence.

sequence_id

string<uuid>

required

String UUID value.

person_id

string<uuid>

required

String UUID value.

mailbox_emails

string<email>[]

required

Candidate mailbox addresses to send from. One is selected at enrollment time. At most 10 addresses are accepted.

Required array length: 1 - 10 elements

String value representing an email address.

allowed_concurrent_sequence_ids

string<uuid>[]

Active sequence IDs that the caller explicitly approved for simultaneous enrollment. Omit this field unless the user reviewed those enrollments.

String UUID value.

Response

Response returned when an enrollment is created.

string<uuid>

required

String UUID value.

created_at

string<date-time>

required

String value representing an RFC 3339 datetime.

updated_at

string<date-time>

required

String value representing an RFC 3339 datetime.

sequence

object

required

Sequence details embedded in enrollment responses.

Show child attributes

person

object

required

Person details embedded in enrollment responses.

Show child attributes

mailbox

object

required

Mailbox details embedded in enrollment responses.

Show child attributes

enrolled_by_play

object | null

required

The play that created the enrollment, if applicable.

Show child attributes

reply_email_message

object | null

required

Reply email message details embedded in enrollment responses.

Show child attributes

status

enum<string>

required

Status of a sequence enrollment.

DRAFT is deprecated and never returned. Drafts waiting for approval are IN_PROGRESS with is_draft_approval_pending set.

Available options:

DRAFT,

IN_PROGRESS,

FINISHED

is_draft_approval_pending

boolean

required

True while an AI-drafted enrollment is waiting for approval. The enrollment does not start until it is approved.

is_blocked

boolean

required

is_bounced

boolean

required

is_canceled

boolean

required

is_excluded

boolean

required

is_opted_out

boolean

required

is_paused

boolean

required

is_replied

boolean

required

started_at

string<date-time> | null

required

String value representing an RFC 3339 datetime.

ended_at

string<date-time> | null

required

String value representing an RFC 3339 datetime.

⌘I

Unify platform

MCP

Developer guides

API reference

SDKs

Create enrollment

Overview

Examples

Handle enrollment conflicts

Authorizations

Body

Response

​Overview

​Examples

​Handle enrollment conflicts

Authorizations

Body

Response

Overview

Examples

Handle enrollment conflicts