v3

latestOpenAPI 3.0.1Proprietary2026-07-314140169.7 KB

Authentication

Generate JWT URL

Generate a secure, single-use URL containing a JWT. Users visit this URL to link their social media accounts. The JWT is valid for 48 hours.

post/uploadposts/users/generate-jwt

Request body

usernamestring required

The user profile identifier for which the JWT is generated.

redirect_urlstring uri

URL to redirect to after linking social accounts.

logo_imagestring uri

URL to a logo image for branding the linking page.

redirect_button_textstring

Text for the redirect button after linking.

connect_titlestring

Custom title for the connection page.

connect_descriptionstring

Custom description for the connection page.

platformsstring[]

Platforms to show for connection. Defaults to all supported platforms.

show_calendarboolean

Whether to show the calendar view on the connection page.

language'en' | 'es' | 'de' | 'fr' | 'pt' | 'pl' | 'tr'

Forces the connection page language for this profile. When omitted, the page auto-detects the visitor's browser language and falls back to English.

ui_labelsobject nullable

Flat object of connect-page i18n dot-path keys mapped to replacement strings, for white-label text overrides beyond connect_title/connect_description/redirect_button_text. Max 100 entries; keys must match ^[a-zA-Z0-9_.]+$; values must be strings of at most 300 characters. Omitting the field leaves previously stored labels untouched; sending null or {} clears them. Returned inside the profile object by GET /uploadposts/users/validate-jwt. Keys refer to the connect page's own translation keys, so only override keys you have confirmed exist.

Example request

{
  "ui_labels": {
    "connect.connectButton": "Baglan",
    "connect.notConnected": "Bagli degil"
  }
}

Response

JWT URL generated successfully.

successboolean

access_urlstring

Secure URL for the user to visit and link accounts.

durationstring

JWT validity period.

Example response

{
  "success": true,
  "duration": "48h"
}