Submit a new integration

POST

/api/partner/integrations

Submits a new partner integration (provider plus one or more actions) for review. The integration is created in an inactive state and remains hidden until a platform reviewer approves it.

Request

Authorization

API Key

Add parameter in cookie

session

Example:

session: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Integration submitted and queued for review.

Bodyapplication/json

🟠400

🟠401

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/partner/integrations' \
--header 'Content-Type: application/json' \
--data '{
    "slug": "acme-crm",
    "name": "Acme CRM",
    "description": "Looks up and updates customer records in Acme CRM.",
    "category": "crm",
    "auth_type": "oauth",
    "oauth_config": {
        "property1": "string",
        "property2": "string"
    },
    "api_key_config": {
        "property1": "string",
        "property2": "string"
    },
    "actions": [
        {
            "slug": "lookup_customer",
            "name": "Look up customer",
            "description": "Finds a customer by phone number.",
            "usage_context": "both",
            "execution_type": "http",
            "http_config": {
                "url": "https://api.example.com/customers/lookup",
                "property1": "string",
                "property2": "string"
            },
            "flow_definition": {
                "property1": "string",
                "property2": "string"
            },
            "parameters_schema": {},
            "agent_instructions": "string",
            "end_of_call_config": {
                "property1": "string",
                "property2": "string"
            },
            "mock_response": {
                "customer_id": "123",
                "name": "Example AS"
            }
        }
    ]
}'

Response Example

201 - Example 1

{
    "success": true,
    "provider_id": "fe3d49af-4061-436b-ae60-f7044f252a44",
    "slug": "partner-acme-crm",
    "status": "pending_review",
    "message": "Integration submitted for review. You will be notified when approved."
}

Modified at 2026-07-08 19:01:40

Remove a pending member

List my integrations