API

Generate an access token

Exchange your API key and secret for a gn-access-token that authenticates every other Genuin API request.

Handle API errors

Every third-party API error carries an HTTP status, a string code, and a message. Match on the code, and retry only what's safe to retry.

Set up single sign-on with your identity provider

Let members sign in to your community with the account they already have, by connecting your OAuth 2.0 or OpenID Connect provider in Brand Control Center.

Create a community

Create a community under your brand from your own systems, with its type, access settings, and first members.

Create a group in a community

Create a group inside a community, with its visibility and posting rules, first members, and an optional opening video.

Add members to a community

Add existing accounts or phone numbers to a community, or approve a pending join request, from your own systems.

Add moderators to a community

Give accounts the moderator role in a community, or add them as moderators, from your own systems.

Update a group and its members

Add or remove members, rename a group, change its description, image, topics, or access settings from your own systems.

Delete a member account

Remove a member's Genuin account on their behalf, the same way the member can from the app, using your brand's API key.

Post a video to a group

Upload a video and its thumbnail, then post it to a group with a caption, mentions, questions, or link-out cards.

Query Genuin event data in BigQuery

Learn what lands in the genuin_data table, column by column, and run the first queries on engagement, campaigns, and searches.

Receive zero-party data in BigQuery

Connect a BigQuery dataset in Settings > Data Sources. Brand Control Center creates a genuin_data table and fills it with your community's event rows on a daily, weekly, or monthly schedule.

Push analytics data to Mixpanel

Connect a Mixpanel project in Brand Control Center with a service account so engagement events sync to it on a schedule.

Push analytics data to Amazon S3

Connect an S3 bucket in Brand Control Center so your analytics export lands in your own storage as CSV or Parquet files on a schedule.