GenuineAIGenuineAI
For usersFor developers
  • Overview
  • Guides
  • How-to
  • API reference
Documentation
  • Quickstart
  • Authentication
  • Errors
  • Rate limits
  • API reference
Platform
  • Platform overview
  • Solutions
  • Pricing
  • Sign in
Company
  • Status
  • Trust Center
  • Contact
  • Terms of Service
  • Privacy Policy

© 2026 GenuineAI Ventures LLC

support@genuinehq.com
Overview
Core
Media library
AI
Documents
Knowledge
Creative
Website & content
Automation
Customer channels
Administration
    Users
    Roles
    Workspace settings
    Audit
    Storage
    Usage breakdown
    Media tag groups
    Media status flows
    Issued share links
    Social connections
      Start a connectiongetFinish a connectionpostDisconnect an accountdelete
    Social calendar
Schemas
GenuineAI API
GenuineAI API

Social connections

Connecting a social account to the workspace and disconnecting it — the credential everyone's posts are published under.


Start a connection

GET
https://api.genuineai.app/api/v1
/admin/social/{platform}/auth-url

Returns the URL to send the person to. Nothing is connected until the callback comes back.

Requires the module-social-post license feature. Without it the request is refused with 403 license_required — see plans and modules.

Start a connection › path Parameters

platform
​string · enum · required
Enum values:
instagram

Start a connection › query Parameters

redirect_uri
​string · required

Start a connection › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Start a connection › Responses

Success

No data returned
GET/admin/social/{platform}/auth-url
curl 'https://api.genuineai.app/api/v1/admin/social/:platform/auth-url?redirect_uri=<string>' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Finish a connection

POST
https://api.genuineai.app/api/v1
/admin/social/{platform}/callback

Exchanges the code the platform redirected back with for a stored connection. This is the second half of the flow auth-url starts.

Requires the module-social-post license feature. Without it the request is refused with 403 license_required — see plans and modules.

Finish a connection › path Parameters

platform
​string · enum · required
Enum values:
instagram

Finish a connection › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Finish a connection › Request Body

code
​string · required
redirect_uri
​string · required
state
​string

Finish a connection › Responses

Success

No data returned
POST/admin/social/{platform}/callback
curl https://api.genuineai.app/api/v1/admin/social/:platform/callback \ --request POST \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "code": "code", "redirect_uri": "redirect_uri", "state": "state" }'
Example Request Body
{ "code": "code", "redirect_uri": "redirect_uri", "state": "state" }
json
Example Responses
No example specified for this content type

Disconnect an account

DELETE
https://api.genuineai.app/api/v1
/admin/social/{platform}/disconnect

Publishing to that platform stops working. Posts already published are unaffected.

Requires the module-social-post license feature. Without it the request is refused with 403 license_required — see plans and modules.

Disconnect an account › path Parameters

platform
​string · enum · required
Enum values:
instagram

Disconnect an account › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Disconnect an account › Responses

Success

No data returned
DELETE/admin/social/{platform}/disconnect
curl https://api.genuineai.app/api/v1/admin/social/:platform/disconnect \ --request DELETE \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Issued share linksSocial calendar