Connect Links
Generate magic OAuth connect links for end-user social account connection without exposing your credentials or Aether branding.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/connect-links"{ "success": true, "data": [ { "id": "cl_abc123", "organizationId": "string", "platform": "instagram", "label": "string", "url": "http://example.com", "status": "active", "profileId": "string", "expiresAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z" } ]}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Creates a one-time OAuth URL for your end user. Send this URL to the user — when they click it, they'll be redirected to the social platform's OAuth flow. On success, a SocialProfile is created in your organization and a profile.connected webhook event is dispatched. The link expires after 24 hours.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/connect-links" \ -H "Content-Type: application/json" \ -d '{ "platform": "instagram" }'{ "success": true, "data": { "id": "cl_abc123", "organizationId": "string", "platform": "instagram", "label": "string", "url": "http://example.com", "status": "active", "profileId": "string", "expiresAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}