Skip to main content
POST
Create a new OAuth application
Creates a new OAuth2 application for your organization. Only OWNERS and ADMINS can create OAuth apps.
The client secret is returned ONCE in the response. Store it securely immediately - it cannot be retrieved later!

Permissions

Only OWNERS and ADMINS can create OAuth applications.

Request Body

Available Scopes

  • read:user - Read user information
  • write:user - Modify user information
  • read:organization - Read organization data
  • write:organization - Modify organization data
  • read:members - Read member information
  • write:members - Modify members
  • read:webhooks - Read webhook configuration
  • write:webhooks - Manage webhooks
  • admin:organization - Full organization admin access
  • admin:all - Full system access

Example Request

Example Response

Security Notes

  • The clientSecret is only returned once during creation
  • Store the secret securely (environment variables, secret manager)
  • Never commit secrets to version control
  • Rotate secrets if compromised

Common Errors

400 Bad Request

Invalid input data or validation errors.

401 Unauthorized

Authentication required.

403 Forbidden

Only owners and admins can create OAuth applications.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Application name

Required string length: 1 - 100
Example:

"My Integration"

scopes
enum<string>[]
required

OAuth scopes requested

Available options:
read:user,
write:user,
read:organization,
write:organization,
read:members,
write:members,
read:webhooks,
write:webhooks,
admin:organization,
admin:all
Example:
description
string

Application description

Maximum string length: 500
Example:

"Integration for managing organization data"

redirectUri
string

Redirect URI for OAuth flow

Example:

"https://example.com/callback"

Response

OAuth application created successfully. Client secret returned only once - save it immediately!