Skip to main content
POST
Connect an integration through OAuth

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$
projectID
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$
integrationID
string
required

Integration ID (itg_...).

Pattern: ^itg_[a-z2-7]{26}$

Body

application/json
client_id
string
required
Minimum string length: 1
client_secret
string
required
Minimum string length: 1
signing_secret
string
required
Minimum string length: 1
return_to
string

Response

Integration OAuth setup created.

integration_id
string
required
Pattern: ^itg_[a-z2-7]{26}$
setup_revision
integer
required

Integration setup revision captured by this authorization flow.

Required range: x >= 1
provider
string
required
flow_id
string
required
Pattern: ^ioaf_[a-z2-7]{26}$
oauth_url
string<uri>
required
redirect_uri
string<uri>
required
events_url
string<uri>
required
actions_url
string<uri>
required
expires_at
string<date-time>
required