---
title: "Get a link the owner opens to connect an account (OAuth needs a browser)"
method: POST
path: "/social/connect"
tags: ["Social"]
---

# Get a link the owner opens to connect an account (OAuth needs a browser)

`POST /social/connect`

## Request

- Base URL: `https://api.madethis.com/v1`
- URL: `https://api.madethis.com/v1/social/connect`
- Auth: HTTP bearer

## Request body

- object
  - `platform` 'TIKTOK' | 'YOUTUBE' | 'INSTAGRAM' | 'FACEBOOK' | 'TWITTER' | 'THREADS' | 'LINKEDIN' | 'PINTEREST' | 'REDDIT' | 'MASTODON' | 'DISCORD' | 'SLACK' | 'BLUESKY' | 'GOOGLE_BUSINESS' | 'SNAPCHAT', required

## Response `201`

Success envelope.

- object
  - `data` object, required
    - `platform` string, required
    - `connectUrl` string, required
    - `alreadyConnected` boolean, required
    - `requiresOwnerBrowser` true, required
  - `hint` string: One-sentence orientation for agents.
  - `next_action` string: The literal next call an agent would chain.

## Other responses

- `default`: Error envelope — machine-readable `code` plus a docs link.

---

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