Integration overview
Connect an approved community to Genesis Forums with consent-based account linking and attributed comment ingestion.
What you can build
Genesis supports two independent integration capabilities:
- Account linking sends a member from your platform to Genesis, shows them exactly what will be linked, and records their consent. You can ask Genesis to create the opaque URL or generate a signed and encrypted token on your own server.
- Comment ingestion imports a comment into the canonical Forum discussion for a novel. The comment retains your platform's source label and can later resolve to the member's Genesis profile.
Capabilities are enabled separately. An integration can use either capability or both.
Integration lifecycle
- Request partner approval from Genesis.
- Genesis creates an integration and enables only the approved capabilities.
- Store the API key and any private signing key on your server.
- Test link acceptance, rejection, retries, and imported comments against your local or approved environment.
- Complete the go-live checklist and agree production limits with Genesis.
Integrations can be disabled or revoked independently of user accounts and Forum content.
Choose an account-link method
| Method | Best for | Partner requirements |
|---|---|---|
| Genesis-generated opaque link | Most partners and fastest implementation | A server capable of making an authenticated HTTPS request |
| Partner-generated signed link | Partners that do not want to send identity fields in an API request | JWT signing, JWE encryption, key storage, and rotation |
Both methods lead to the same Genesis consent screen. Neither method sends or reuses a password from your platform.
Base URL
Production requests use:
https://forum.genesistudio.com
For local testing, replace it with http://localhost:3007. Never send a production API key to a local environment unless Genesis explicitly provisioned it for that environment.