Posting Profiles

Posting Profiles allow you to group multiple social media accounts (YouTube channels, Instagram accounts, etc.) into a single "Profile". This makes it easy to target the same set of accounts repeatedly without specifying each ID individually in every upload.

Plan Requirement

The Profiles feature is available exclusively for users on Plus and Pro plans.

List Profiles

GET /profiles

Returns all posting profiles created in your XenonFlare account.

Headers

Name	Type	Description
X-API-Key	string	Your API Key.

Response Body

Returns an array of profile objects.

[
  {
    "id": "67b0c...",
    "name": "My Tech Brand",
    "youtubeChannelId": "UC...",
    "instagramAccountId": "1784...",
    "tiktokAccountId": "XXXXX",
    "linkedinAccountId": "urn:li:person:XXXXX",
    "pinterestAccountId": "XXXXX",
    "isDefault": true,
    "createdAt": "2026-02-15T12:00:00.000Z"
  }
]

Field Descriptions

• id: The internal XenonFlare database ID for the profile. Use this value as profileId when uploading.
• name: The display name you gave to the profile.
• youtubeChannelId: The native YouTube Channel ID included in this profile.
• instagramAccountId: The native Instagram Business Account ID.
• tiktokAccountId: The native TikTok Account ID.
• linkedinAccountId: The native LinkedIn ID (URN).
• pinterestAccountId: The native Pinterest User ID.
• isDefault: Whether this is your default profile.

Using a Profile for Upload

When uploading media via the Video Upload or Image Upload API, you can provide a profileId instead of (or in addition to) the platforms and specific account configurations.

example

curl -X POST https://api.xenonflare.com/media/videos \
  -H "X-API-Key: your_api_key" \
  -F "[email protected]" \
  -F "profileId=67b0c..." \
  -F "title=My Brand Post"

If a profileId is provided, XenonFlare will automatically target all accounts associated with that profile.

Configuration Merging

If you provide both a profileId AND platform-specific configurations (e.g., youtube={...}), the platform-specific settings (like custom titles or captions) will be applied to the accounts within that profile.

Errors

• 401 Unauthorized: Missing or invalid API key.
• 403 Forbidden: Your plan does not support the Profiles feature.
• 500 Internal Server Error: An unexpected error occurred.