Create a paused event source

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/event-sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "delivery": {
    "kind": "webhook",
    "verificationCredential": {
      "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
    }
  },
  "displayName": "example",
  "type": "slack_events_api"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/event-sources"

payload = {
    "delivery": {
        "kind": "webhook",
        "verificationCredential": {
            "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
            "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        }
    },
    "displayName": "example",
    "type": "slack_events_api"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    delivery: {
      kind: 'webhook',
      verificationCredential: {
        credentialId: '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
        vaultId: '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d'
      }
    },
    displayName: 'example',
    type: 'slack_events_api'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/event-sources', 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.recursion.labelbox.com/managed-agents/v1/event-sources",
  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([
    'delivery' => [
        'kind' => 'webhook',
        'verificationCredential' => [
                'credentialId' => '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
                'vaultId' => '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d'
        ]
    ],
    'displayName' => 'example',
    'type' => 'slack_events_api'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-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.recursion.labelbox.com/managed-agents/v1/event-sources"

	payload := strings.NewReader("{\n  \"delivery\": {\n    \"kind\": \"webhook\",\n    \"verificationCredential\": {\n      \"credentialId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n      \"vaultId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\"\n    }\n  },\n  \"displayName\": \"example\",\n  \"type\": \"slack_events_api\"\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	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.recursion.labelbox.com/managed-agents/v1/event-sources")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"delivery\": {\n    \"kind\": \"webhook\",\n    \"verificationCredential\": {\n      \"credentialId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n      \"vaultId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\"\n    }\n  },\n  \"displayName\": \"example\",\n  \"type\": \"slack_events_api\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/event-sources")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"delivery\": {\n    \"kind\": \"webhook\",\n    \"verificationCredential\": {\n      \"credentialId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n      \"vaultId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\"\n    }\n  },\n  \"displayName\": \"example\",\n  \"type\": \"slack_events_api\"\n}"

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

{
  "createdAt": "2026-02-18T09:30:00.000Z",
  "delivery": {
    "kind": "webhook",
    "verification": {
      "signatureHeader": "example",
      "signaturePrefix": "example",
      "signedParts": [
        {
          "kind": "body"
        }
      ],
      "type": "none",
      "verificationCredential": {
        "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
        "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
      }
    },
    "verificationCredential": {
      "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
    },
    "webhookUrl": "example"
  },
  "displayName": "example",
  "eventSourceId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "revision": 1,
  "status": "paused",
  "type": "slack_events_api",
  "updatedAt": "2026-02-18T09:30:00.000Z"
}

{
  "code": "invalid_request",
  "message": "<string>",
  "details": {}
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "conflict",
  "message": "<string>",
  "details": {}
}

{
  "code": "payload_too_large",
  "message": "<string>",
  "details": {}
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {}
}

{
  "code": "semantic_validation_failed",
  "message": "<string>",
  "details": {}
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {}
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "idempotency_unavailable",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

POST

managed-agents

event-sources

Create a paused event source

curl --request POST \
  --url https://api.recursion.labelbox.com/managed-agents/v1/event-sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "delivery": {
    "kind": "webhook",
    "verificationCredential": {
      "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
    }
  },
  "displayName": "example",
  "type": "slack_events_api"
}
'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/event-sources"

payload = {
    "delivery": {
        "kind": "webhook",
        "verificationCredential": {
            "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
            "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        }
    },
    "displayName": "example",
    "type": "slack_events_api"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    delivery: {
      kind: 'webhook',
      verificationCredential: {
        credentialId: '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
        vaultId: '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d'
      }
    },
    displayName: 'example',
    type: 'slack_events_api'
  })
};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/event-sources', 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.recursion.labelbox.com/managed-agents/v1/event-sources",
  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([
    'delivery' => [
        'kind' => 'webhook',
        'verificationCredential' => [
                'credentialId' => '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d',
                'vaultId' => '9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d'
        ]
    ],
    'displayName' => 'example',
    'type' => 'slack_events_api'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-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.recursion.labelbox.com/managed-agents/v1/event-sources"

	payload := strings.NewReader("{\n  \"delivery\": {\n    \"kind\": \"webhook\",\n    \"verificationCredential\": {\n      \"credentialId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n      \"vaultId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\"\n    }\n  },\n  \"displayName\": \"example\",\n  \"type\": \"slack_events_api\"\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	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.recursion.labelbox.com/managed-agents/v1/event-sources")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"delivery\": {\n    \"kind\": \"webhook\",\n    \"verificationCredential\": {\n      \"credentialId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n      \"vaultId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\"\n    }\n  },\n  \"displayName\": \"example\",\n  \"type\": \"slack_events_api\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/event-sources")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"delivery\": {\n    \"kind\": \"webhook\",\n    \"verificationCredential\": {\n      \"credentialId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\",\n      \"vaultId\": \"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d\"\n    }\n  },\n  \"displayName\": \"example\",\n  \"type\": \"slack_events_api\"\n}"

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

{
  "createdAt": "2026-02-18T09:30:00.000Z",
  "delivery": {
    "kind": "webhook",
    "verification": {
      "signatureHeader": "example",
      "signaturePrefix": "example",
      "signedParts": [
        {
          "kind": "body"
        }
      ],
      "type": "none",
      "verificationCredential": {
        "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
        "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
      }
    },
    "verificationCredential": {
      "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
    },
    "webhookUrl": "example"
  },
  "displayName": "example",
  "eventSourceId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "revision": 1,
  "status": "paused",
  "type": "slack_events_api",
  "updatedAt": "2026-02-18T09:30:00.000Z"
}

{
  "code": "invalid_request",
  "message": "<string>",
  "details": {}
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "conflict",
  "message": "<string>",
  "details": {}
}

{
  "code": "payload_too_large",
  "message": "<string>",
  "details": {}
}

{
  "code": "unsupported_media_type",
  "message": "<string>",
  "details": {}
}

{
  "code": "semantic_validation_failed",
  "message": "<string>",
  "details": {}
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {}
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "idempotency_unavailable",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

A Recursion API key, created in the console under API keys.

Headers

Idempotency-Key

string

required

Replay-protection key in an organization-wide namespace shared by keyed mutations. It must contain 1 to 256 visible ASCII characters and be sent as exactly one header value. Request identity is the exact HTTP method, escaped path, raw query, and raw body bytes. The same request replays the original successful response; any different request returns 409 idempotency_conflict, and an active matching request returns 409 idempotency_in_progress. Completed receipts are retained for approximately 24 hours, pending claims may be reclaimed after approximately 1 hour, and no deduplication is guaranteed after expiry.

Required string length: 1 - 256

Pattern: ^[!-~]+$

Body

application/json

Option 1
Option 2
Option 3
Option 4

Closed configuration for a Slack Events API source.

delivery

object

required

Customer-configured webhook delivery and verification.

Show child attributes

Example:

{
  "kind": "webhook",
  "verificationCredential": {
    "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
    "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
  }
}

displayName

string

required

Human-readable source name shown in the automation catalog.

Required string length: 1 - 256

type

enum<string>

required

Slack Events API protocol, verified with Slack's request signature.

Available options:

slack_events_api

Response

Configured inbound event source, including its verification policy and lifecycle state.

createdAt

string<date-time>

required

read-only

Time the event source was created.

delivery

object

required

Customer-owned webhook endpoint and its non-secret verification configuration.

Option 1
Option 2

Show child attributes

Example:

{
  "kind": "webhook",
  "verification": {
    "signatureHeader": "example",
    "signaturePrefix": "example",
    "signedParts": [{ "kind": "body" }],
    "type": "none",
    "verificationCredential": {
      "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
    }
  },
  "verificationCredential": {
    "credentialId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
    "vaultId": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
  },
  "webhookUrl": "example"
}

displayName

string

required

Human-readable source name shown in the automation catalog.

eventSourceId

string<uuid>

required

read-only

Stable identifier for the event source.

revision

integer<int64>

required

read-only

Monotonic revision represented by the response ETag.

Required range: x >= 1

status

enum<string>

required

read-only

Lifecycle state. Custom webhook sources start paused; connection-managed sources start active.

Available options:

paused,

active

type

enum<string>

required

Inbound provider protocol interpreted by this source.

Available options:

slack_events_api,

github_webhook,

custom_webhook

updatedAt

string<date-time>

required

read-only

Time the event source was last changed.

API reference

Endpoints

Create a paused event source

Authorizations

Headers

Body

Response