---
title: "Create a hosted connect portal"
method: POST
path: "/socials/portal"
tags: ["Socials"]
---

# Create a hosted connect portal

`POST /socials/portal`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/socials/portal`
- Auth: API key in header `Authorization`

Returns the URL of Crevio's hosted integrations page, where the user can connect, reconnect, and disconnect every social platform in one place. For a direct per-platform OAuth URL, use POST /socials/connect.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `redirect_url` string, required
  - `platforms` string[]

## Response `200`

Hosted portal URL

- object
  - `url` string, required: URL of the hosted connect page
  - `note` string

## Other responses

- `401`: Authentication required
- `403`: Forbidden
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)