---
title: "Create a connect link for a channel"
method: POST
path: "/integrations/connect"
tags: ["Integrations"]
---

# Create a connect link for a channel

`POST /integrations/connect`

## Request

- Base URL: `https://api.postiz.com/public/v1`
- URL: `https://api.postiz.com/public/v1/integrations/connect`
- Auth: API key in header `Authorization`

Create a link to a Postiz page where someone can connect a new channel. The page explains what connecting the account to Postiz means, and the person is sent to the platform to sign in and approve only after they choose to continue. The link works for one hour and the person opening it does not need a Postiz account. Only integrations that connect through a sign-in redirect are supported.

## Request body

- object
  - `integration` string, required: The integration identifier (e.g. x, linkedin, facebook, instagram, youtube, reddit, etc.)
  - `redirectUrl` string, uri: Where the person is sent once the channel is connected. An http or https URL without a fragment. When omitted, they stay on Postiz.

## Response `201`

Connect link

- object
  - `url` string: The Postiz page to send the person to

## Other responses

- `400`: Integration not allowed, an integration that cannot be connected with a link, or an invalid redirectUrl
- `402`: The plan has no channels left

## Changes

- **2026-11-13** `269b4fe5c86b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/postiz/apis/postiz-public-api/changes/integrations/connect/post.md)

---

[API](https://skmtc.dev/postiz/apis/postiz-public-api.md) - [All operations](https://skmtc.dev/postiz/apis/postiz-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postiz/apis/postiz-public-api/revisions/269b4fe5c86b?raw)