---
title: "Create integration binding"
method: POST
path: "/api/v1/sockets/{socket_id}/integrations"
tags: ["sockets"]
---

# Create integration binding

`POST /api/v1/sockets/{socket_id}/integrations`

Create a new integration binding for a socket

## Path parameters

- `socket_id` string, required

## Request body

- IntegrationBindingCreate — Model for creating integration bindings.
  - `integration_type` string, required — Type of integration
  - `integration_name` string, required — Name of the integration
  - `permissions` SpacePermissions, required — Permission model for socket integration bindings.
    - `can_read` boolean — Permission to read memories
    - `can_write` boolean — Permission to create memories
    - `can_search` boolean — Permission to search memories
    - `can_delete` boolean — Permission to delete memories
    - `filters` object, nullable — Content filtering rules
    - `rate_limits` object, nullable — Rate limiting configuration
  - `auth_config` object, required — Authentication configuration

## Response `201`

Successful Response

- IntegrationBinding — Full integration binding model.
  - `integration_type` string, required — Type of integration
  - `integration_name` string, required — Name of the integration
  - `permissions` SpacePermissions, required — Permission model for socket integration bindings.
    - `can_read` boolean — Permission to read memories
    - `can_write` boolean — Permission to create memories
    - `can_search` boolean — Permission to search memories
    - `can_delete` boolean — Permission to delete memories
    - `filters` object, nullable — Content filtering rules
    - `rate_limits` object, nullable — Rate limiting configuration
  - `auth_config` object, required — Authentication configuration
  - `binding_id` string, required — Unique binding identifier
  - `socket_id` string, required — Socket this binding belongs to
  - `is_active` boolean — Whether binding is active
  - `status` string — Binding status: pending (waiting for first memory), active (has received memory), inactive (manually deactivated)
  - `created_at` string, date-time, required — Creation timestamp
  - `last_used` string, date-time, nullable — Last used timestamp
  - `access_token_preview` string, nullable — Preview of access token

## Other responses

- `403` — Access denied
- `404` — Socket not found
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.net/memara/apis/memara-api.md) · [All operations](https://skmtc.net/memara/apis/memara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memara/memara-api/revisions/4dc7c4418845/schema)