Author Creation
Authors are automatically created when anauthor_id
is included in submit content requests. However, you can also manually create authors using the API before submitting content.
We recommend adding detailed author information using the update endpoint after automatic creation, or creating authors ahead of time with complete details to improve initial trust scoring accuracy.
Prerequisites
- Dashboard: You need the moderator role for your project
- API: Any valid API key for the project
Available Fields
Basic Information
These fields are displayed in the dashboard for easier author management:The author’s display name
Author’s email address
URL to the author’s profile image
URL to the author’s profile on your platform or other external resources. Will
add a clickable link in the dashboard.
Metadata
A flexible JSON object that can store any additional author information
- Limits: Maximum 25 keys with 1 level of nesting
- Usage: Included in webhooks and author API responses
- Purpose: Store custom data relevant to your use case
Example
Built-in Metadata Fields
These special metadata fields are used for trust levels and fraud detection, and are rendered in the dashboard:Boolean indicating if email is verified
Boolean indicating if phone number is verified
Boolean indicating if identity has been verified
Boolean indicating if the user is a paying customer
Built-in metadata example
Trust Level Override
Override automatic trust level calculations for this author
- Range: -1 to 4, or
null
to reset to automatic calculation - Use cases: Permanently promote or demote specific users
- Reset: Set to
null
to return to automatic trust level calculation - Impact: Affects moderation decisions and user permissions
Timestamps
These timestamp fields help with trust scoring and fraud detection:When the author was first encountered in your system (timestamp in
milliseconds)
The author’s most recent activity timestamp (timestamp in milliseconds)
Making Updates
- API
- Dashboard
Use the PUT /authors/ endpoint to programmatically update author information. If you need to create a new author, use the POST /authors/ endpoint.Here’s a complete example of updating an author with all available fields: