# API

Learn about the Genuin API: endpoints under /api/thirdparty, authenticated with a gn-access-token.

## Get Started

- [Generate an access token](https://begenuin.com/developers/developer-resources/api/generate-access-token-using-authentication-api): Exchange your API key and secret for a gn-access-token that authenticates every other Genuin API request.
- [Handle API errors](https://begenuin.com/developers/developer-resources/api/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](https://begenuin.com/developers/developer-resources/overview/log-in-seamlessly-across-your-brand-ecosystem-using-sso): Let members sign in to your social experience with the account they already have, by connecting your OAuth 2.0 or OpenID Connect provider in your Business Account.

## Build

- [Create a community](https://begenuin.com/developers/developer-resources/api/create-a-community-programmatically-using-community-api): Create a community under your brand from your own systems, with its type, access settings, and first members.
- [Create a group in a community](https://begenuin.com/developers/developer-resources/api/create-a-group-programmatically-within-community-using-create-group-api): Create a group inside a community, with its visibility and posting rules, first members, and an optional opening video.
- [Add members to a community](https://begenuin.com/developers/developer-resources/api/add-members-to-a-community-programmatically-api): Add existing accounts or phone numbers to a community, or approve a pending join request, from your own systems.
- [Add moderators to a community](https://begenuin.com/developers/developer-resources/api/assign-moderators-to-community-using-api): Give accounts the moderator role in a community, or add them as moderators, from your own systems.
- [Update a group and its members](https://begenuin.com/developers/developer-resources/api/add-or-manage-group-members-collaborators-using-api): Add or remove members, rename a group, change its description, image, topics, or access settings from your own systems.
- [Delete a member account](https://begenuin.com/developers/developer-resources/api/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.

## Distribute and Grow

- [Post a video to a group](https://begenuin.com/developers/developer-resources/api/post-and-share-a-video-within-a-group-using-the-post-video-api): Upload a video and its thumbnail, then post it to a group with a caption, mentions, questions, or link-out cards.

## Integrations

- [Query Genuin event data in BigQuery](https://begenuin.com/developers/developer-resources/api/integrate-google-bigquery-with-business-account): 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](https://begenuin.com/developers/developer-resources/overview/connect-bigquery-to-the-business-account-to-receive-zero-party-data): Connect a BigQuery dataset in Settings > Data Sources. Business Account creates a genuin_data table and fills it with your social experience's event rows on a daily, weekly, or monthly schedule.
- [Push analytics data to Mixpanel](https://begenuin.com/developers/developer-resources/overview/integrate-mixpanel-with-business-account): Connect a Mixpanel project in your Business Account with a service account so engagement events sync to it on a schedule.
- [Push analytics data to Amazon S3](https://begenuin.com/developers/developer-resources/overview/how-do-i-integrate-amazon-s3-bucket-with-business-account-to-push-analytics-data): Connect an S3 bucket in your Business Account so your analytics export lands in your own storage as CSV or Parquet files on a schedule.