Skip to main content
POST
/
partners
Create partner
curl --request POST \
  --url https://api.agentic.scope3.com/api/v2/partner/partners \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Activation"
}
'
{
  "id": "12345",
  "name": "Acme Activation",
  "status": "ACTIVE",
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-20T14:45:00Z",
  "description": "Activation partner for Acme Corporation"
}

Authorizations

Authorization
string
header
required

API key or access token

Body

application/json

Request body for creating a new partner

name
string
required

Name of the partner

Required string length: 1 - 255
Example:

"Acme Activation"

description
string

Optional description of the partner

Maximum string length: 1000
Example:

"Activation partner for Acme Corporation"

Response

Create partner

Partner resource representation

id
string
required

Unique identifier for the partner

Example:

"12345"

name
string
required

Name of the partner

Example:

"Acme Activation"

status
enum<string>
required

Current status of the partner

Available options:
ACTIVE,
ARCHIVED
createdAt
string<date-time>
required

When the partner was created (ISO 8601)

Example:

"2025-01-15T10:30:00Z"

updatedAt
string<date-time>
required

When the partner was last updated (ISO 8601)

Example:

"2025-01-20T14:45:00Z"

description
string

Description of the partner

Example:

"Activation partner for Acme Corporation"