MOmosaic
Social

Create social connection

Create a short-lived social account setup URL for a new connection.

post/social/connections

Request

  • Base URL
    https://api.mosaic.so
  • URL
    https://api.mosaic.so/social/connections
  • Auth
    • HTTP bearer
    • or API key in header X-API-Key

Request body

platform'x' | 'linkedin' | 'instagram' | 'facebook' | 'tiktok' | 'youtube' required
connection_namestring

Name displayed on the hosted connection page for a new profile. Leading and trailing whitespace is trimmed. Duplicate names are allowed; use social_profile_id to identify distinct profiles. Omit to use a generated name. Does not rename an existing profile or social account.

social_profile_idstring uuid

Reuse an existing social profile without creating another profile slot. connection_name does not rename the existing profile.

redirect_urlstring uri

Response

Connect URL created

platform'x' | 'linkedin' | 'instagram' | 'facebook' | 'tiktok' | 'youtube' required
social_profile_idstring uuid

ID of the new or reused social profile. Distinct profiles may share the same connection_name.

connect_urlstring uri required

Short-lived Mosaic URL that opens the social account setup flow.

Changes

No recorded changes to this operation across all 1 revision of this API.