Skip to main content
POST
/
api
/
v1
/
integration-account
/
{integrationAccountID}
/
reauthorize
Begin OAuth reauthorization flow for an existing integration account
curl --request POST \
  --url https://api.example.com/api/v1/integration-account/{integrationAccountID}/reauthorize \
  --header 'Content-Type: application/json' \
  --header 'x-calry-api-key: <api-key>' \
  --data '
{
  "clientRedirectURL": "https://app.example.com/integrations/hostfully/success",
  "notificationURL": "https://api.example.com/oauth/notifications",
  "name": "Downtown Portfolio"
}
'
{
  "oAuthURL": "https://provider.com/oauth/authorize?client_id=abc&redirect_uri=xyz",
  "workspaceLevelWebhookSubscriptionSupport": true,
  "subscriptionAPISupport": true,
  "webhookURLs": [
    "https://api.example.com/webhooks/12345"
  ]
}

Authorizations

​
x-calry-api-key
string
header
required

Headers

​
x-calry-tenant-id
string

Optional tenant ID to specify which tenant to operate as. Controls access to integration accounts. If not provided, the default tenant will be used.

Path Parameters

​
integrationAccountID
string
required

The integration account ID to reauthorize

Body

application/json
​
clientRedirectURL
string
required

Client redirect URL to send the user back to after OAuth completes.

Example:

"https://app.example.com/integrations/hostfully/success"

​
notificationURL
string
required

Webhook URL Zepl should POST the OAuth result to once complete.

Example:

"https://api.example.com/oauth/notifications"

​
name
string

Optional label to display during consent; defaults to the existing account name.

Example:

"Downtown Portfolio"

Response

OAuth reauthorization URL generated successfully

​
oAuthURL
string
required

URL to redirect the user for OAuth authorization

Example:

"https://provider.com/oauth/authorize?client_id=abc&redirect_uri=xyz"

​
workspaceLevelWebhookSubscriptionSupport
boolean
required

Whether the provider supports workspace-level webhook subscription

Example:

true

​
subscriptionAPISupport
boolean
required

Whether the provider supports subscription API

Example:

true

​
webhookURLs
string[]

URLs for webhooks configured for this integration

Example:
["https://api.example.com/webhooks/12345"]