Connect Links

Magic OAuth URLs that let users connect social accounts without implementing OAuth.

Connect Links are Aether's account-connection flow. Generate a URL, send it to your user, and when they complete OAuth the SocialProfile appears in your organization.

How it works

Call POST /v1/connect-links to generate a link
Send the url to your user (email, in-app button, etc.)
The user completes OAuth with the platform
Aether redirects to your redirectUrl (optional) or the dashboard
The new SocialProfile is available via GET /v1/profiles

Creating a Connect Link

curl -X POST https://api.aetherhq.dev/v1/connect-links \
  -H "Authorization: Bearer $AETHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "instagram",
    "label": "Main Instagram",
    "redirectUrl": "https://yourapp.com/accounts/connected"
  }'

const link = await client.connectLinks.create({
  platform: "instagram",
  label: "Main Instagram",
  redirectUrl: "https://yourapp.com/accounts/connected",
});
console.log(link.url);

Link expiry

Connect Links expire after 24 hours and can only be used once. Generate a new link if the user needs to reconnect.

Supported platforms (V1)

Platform	API value	Status
Instagram	`instagram`	Available
Facebook	`facebook`	Available
Threads	`threads`	Available
TikTok	`tiktok`	Available
LinkedIn	`linkedin`	Available

Coming soon

YouTube and Reddit connectors exist but OAuth connect is not yet enabled. See Platforms.

Webhook events

connect_link.used — fired when a user completes OAuth via the link
connect_link.expired — fired when a link expires unused

See Webhooks for signature verification.