Create Integration

POST

/org/:org_id/project/:project_id/integration

POST

/api/v1/org/:org_id/project/:project_id/integration

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/integration \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "type": "google_sheets"
> }'

1 {
2   "id": "019f8a04-5e54-7001-9f5e-6e9031824041",
3   "project_id": "019f8a00-1a10-7002-8b1a-2a5c9d4e0002",
4   "type": "slack",
5   "name": "Slack",
6   "auth_type": "oauth_project_default",
7   "created": "2026-05-10T10:00:00Z",
8   "modified": "2026-05-10T10:00:00Z",
9   "tools": [
10     {
11       "id": "019f8a04-5e54-7003-9f5e-6e9031824043",
12       "name": "slack_chat_post_message",
13       "tool_name": "slack_chat_post_message",
14       "safe_tool_name": "slack_chat_post_message",
15       "enabled": true,
16       "default_selected": true,
17       "created": "2026-05-10T10:00:00Z",
18       "modified": "2026-05-10T10:00:00Z",
19       "description": "Post a message to a Slack channel after validating the channel ID or name.",
20       "tool_description": "Post a message to a Slack channel after validating the channel ID or name.",
21       "tool_input_schema": {
22         "properties": {
23           "channel_id": {
24             "description": "Slack channel ID. Provide exactly one of channel_id or channel_name.",
25             "type": "string"
26           },
27           "channel_name": {
28             "description": "Slack channel name without #. Provide exactly one of channel_id or channel_name.",
29             "type": "string"
30           },
31           "mrkdwn": {
32             "description": "Whether Slack mrkdwn formatting is enabled. Defaults to true.",
33             "type": "boolean"
34           },
35           "text": {
36             "description": "Message text to post.",
37             "type": "string"
38           },
39           "thread_ts": {
40             "description": "Optional thread timestamp to reply in a thread.",
41             "type": "string"
42           }
43         },
44         "required": [
45           "text"
46         ],
47         "type": "object"
48       }
49     }
50   ],
51   "setup_instructions": "Connect Slack so agents can list channels and post messages through the project bot installation."
52 }

Create a new platform integration for the project and persist its discovered tools.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Request

This endpoint expects an object.

typeenumRequired

configmap from strings to any or nullOptional

Reserved for provider-specific config. Google integrations ignore this in v1. Slack may accept {“slack_installation_id”: “<uuid>”} to link an existing active Slack installation. Teams ignores create-time config and is linked after creation from the Teams setup tab.

Response

Integration created

idstringformat: "uuid"

project_idstringformat: "uuid"

typeenum

namestring

auth_typeenum

createdstring

modifiedstring

configmap from strings to any or nullOptional

toolslist of objectsOptionalDefaults to []

setup_instructionsstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error