# Integrations API Reference

REST schemas and generated examples for connecting and managing third-party integrations.

<!-- docs-source -->
Source: https://learning.monetizekit.app/docs/api-reference/integrations
<!-- /docs-source -->

Mock API reference used by the interactive docs explorer.

| OpenAPI version | Contract version | REST base path |
| --- | --- | --- |
| 3.1.0 | 2026-03-15 | /api/v1 |

## Servers

| URL | Environment |
| --- | --- |
| `https://app.monetizekit.app/api/v1` | Development environment |
| `https://app.monetizekit.app/api/v1` | Staging environment |
| `https://app.monetizekit.app/api/v1` | Production environment |

## integrations operations

### Connect Stripe

`POST /integrations/stripe` — Creates a Stripe connect session for workspace setup.

Operation ID: connectStripe.

Required scopes: integrations:manage.

#### Request schema

```json
{
  "type": "object",
  "required": [
    "action"
  ],
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "connect",
        "disconnect",
        "set_webhook_secret"
      ]
    },
    "apiKey": {
      "type": "string"
    },
    "secret": {
      "type": "string"
    }
  }
}
```

#### Request example

```json
{
  "action": "connect",
  "apiKey": "rk_test_placeholder"
}
```

#### Responses

`200` — Success

```json
{
  "type": "object",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    }
  }
}
```

```json
{
  "ok": true
}
```