curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/providers" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"provider": "calendar_provider_a",
"redirect_uri": "https://example.com/oauth/calendar/callback"
}'
{
"success": true,
"data": {
"id": "conn-uuid-1",
"provider": "calendar_provider_a",
"authorization_url": "https://provider.example.com/oauth/authorize?.",
"is_active": false
}
}
Provider Connections
Create Provider Connection
Connect a calendar to an external provider
POST
/
api
/
v1
/
calendars
/
{calendar_id}
/
providers
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/providers" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"provider": "calendar_provider_a",
"redirect_uri": "https://example.com/oauth/calendar/callback"
}'
{
"success": true,
"data": {
"id": "conn-uuid-1",
"provider": "calendar_provider_a",
"authorization_url": "https://provider.example.com/oauth/authorize?.",
"is_active": false
}
}
Create Provider Connection
Initiate a connection between a calendar and an external calendar provider. The OAuth flow is completed via a redirect URL returned in the response.Endpoint
POST /api/v1/calendars/{calendar_id}/providers
Path parameters
string
required
Calendar UUID.
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be
application/json.Request body
string
required
Provider identifier (returned by your environment configuration).
string
required
URL the provider will redirect to after the user authorizes access.
Examples
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/providers" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"provider": "calendar_provider_a",
"redirect_uri": "https://example.com/oauth/calendar/callback"
}'
Response
{
"success": true,
"data": {
"id": "conn-uuid-1",
"provider": "calendar_provider_a",
"authorization_url": "https://provider.example.com/oauth/authorize?.",
"is_active": false
}
}
Notes
- After the user completes the OAuth flow at
authorization_url, the connection becomes active and the first sync runs automatically.
Was this page helpful?