Skip to main content
POST
Create calendar sync authorization URL

Authorizations

Authorization
string
header
required

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

Path Parameters

provider
enum<string>
required

Calendar provider slug.

Available options:
google,
microsoft

Body

application/json
mode
enum<string>
required
Available options:
connect,
reconnect
Example:

"connect"

return_url
string<uri> | null

Optional consumer frontend URL to return to after provider approval. Unsafe origins are ignored and replaced with the configured Upcoming Payments URL.

Maximum string length: 2048
Example:

"https://consumer.younegotiate.com/upcoming-payments"

Response

Authorization URL returned.

data
object
required
Last modified on July 19, 2026