Initialize Orchestrator First Reply

POST https://api.revreply.com/v1/orchestrator/firstreply

This endpoint requires authentication.

Try it

Use the following request to initialize the orchestrator first reply:

cURL
JavaScript
Python
PHP
Go

curl -X POST "https://api.revreply.com/v1/orchestrator/firstreply" \
  -H "Authorization: Bearer <YOUR_JWT>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": 12345,
    "cc_emails": [
      {
        "sender": {
          "first_name": "John",
          "last_name": "Smith"
        },
        "email": "john.smith@example.com"
      }
    ]
  }'

const response = await fetch(
  "https://api.revreply.com/v1/orchestrator/firstreply",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer <YOUR_JWT>",
      "Accept": "application/json",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      lead_id: 12345,
      cc_emails: [
        {
          sender: {
            first_name: "John",
            last_name: "Smith"
          },
          email: "john.smith@example.com"
        }
      ]
    })
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.revreply.com/v1/orchestrator/firstreply",
    headers={
        "Authorization": "Bearer <YOUR_JWT>",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "lead_id": 12345,
        "cc_emails": [
            {
                "sender": {
                    "first_name": "John",
                    "last_name": "Smith",
                },
                "email": "john.smith@example.com",
            }
        ],
    },
)
data = response.json()
print(data)

<?php
$ch = curl_init("https://api.revreply.com/v1/orchestrator/firstreply");

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer <YOUR_JWT>",
        "Accept: application/json",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "lead_id" => 12345,
        "cc_emails" => [
            [
                "sender" => [
                    "first_name" => "John",
                    "last_name" => "Smith",
                ],
                "email" => "john.smith@example.com",
            ],
        ],
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

package main

import (
    "bytes"
    "fmt"
    "net/http"
)

func main() {
    body := []byte(`{
      "lead_id": 12345,
      "cc_emails": [
        {
          "sender": {
            "first_name": "John",
            "last_name": "Smith"
          },
          "email": "john.smith@example.com"
        }
      ]
    }`)

    req, _ := http.NewRequest(
        "POST",
        "https://api.revreply.com/v1/orchestrator/firstreply",
        bytes.NewBuffer(body),
    )

    req.Header.Set("Authorization", "Bearer <YOUR_JWT>")
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    response, _ := client.Do(req)
    fmt.Println(response.Status)
}

Authentication

This endpoint uses Bearer authentication with a JWT.

Request

Headers

Header	Type	Required	Description
`Authorization`	`string`	Yes	Bearer token used to authenticate the request.
`Accept`	`string`	Yes	Specifies that the client expects the response in JSON format.
`Content-Type`	`string`	Yes	Specifies that the request body is formatted as JSON.

Authorization: Bearer <YOUR_JWT>
Accept: application/json
Content-Type: application/json

Body

The request body uses the FirstReplyRequest schema.

Field	Type	Required	Description	Example
`lead_id`	`integer`	Yes	ThreadState ID of the thread to activate.	`12345`
`cc_emails`	`array[object] \| null`	No	CC email information to add to the thread. When provided, the array must contain at least one item.	`[{"sender":{"first_name":"John","last_name":"Smith"},"email":"john.smith@example.com"}]`

`cc_emails` item

Each CC email object contains:

Field	Type	Required	Description	Example
`sender.first_name`	`string`	Yes	Sender’s first name.	`John`
`sender.last_name`	`string`	Yes	Sender’s last name.	`Smith`
`email`	`string`	Yes	Sender’s email address.	`john.smith@example.com`

The sender object requires both first_name and last_name, while email is required and uses email format validation.

Request structure

{
  "lead_id": 12345,
  "cc_emails": [
    {
      "sender": {
        "first_name": "John",
        "last_name": "Smith"
      },
      "email": "john.smith@example.com"
    }
  ]
}

Request examples

The request is a POST request to:

https://api.revreply.com/v1/orchestrator/firstreply

Response

Response structure

A successful request returns confirmation that the thread was activated, along with the lead_id.

Field	Type	Required	Description
`success`	`integer`	Yes	Indicates whether the operation was successful.
`lead_id`	`integer`	Yes	ThreadState ID of the activated thread.

Response example

{
  "success": 1,
  "lead_id": 12345
}

Errors

422 — Validation error

Returned when one or more request fields fail validation.

{
  "success": 0,
  "message": "Validation failed",
  "errors": {}
}

500 — Orchestration failed

Returned when the orchestrator cannot activate the thread.

{
  "success": 0,
  "message": "Something went wrong"
}

System

Users

Agents

Responses

Threads

Orchestrator

Initialize Orchestrator First Reply

Try it

Authentication

Request

Headers

Body

`cc_emails` item

Request structure

Request examples

Response

Response structure

Response example

Errors

422 — Validation error

500 — Orchestration failed

​Try it

​Authentication

​Request

​Headers

​Body

​cc_emails item

​Request structure

​Request examples

​Response

​Response structure

​Response example

​Errors

​422 — Validation error

​500 — Orchestration failed

Try it

Authentication

Request

Headers

Body

`cc_emails` item

Request structure

Request examples

Response

Response structure

Response example

Errors

422 — Validation error

500 — Orchestration failed