Update an OAuth2 connection

PUT /api/v1/oauth/connections/{oauthConnection_uuid}
Personal access token & O auth2

Path parameters

  • oauthConnection_uuid string Required
application/json

Body

  • label string

    The label of the OAuth2 connection

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • uuid string

      The UUID of the resource.

    • created_at string

      The timestamp of when the resource was created.

    • updated_at string

      The timestamp of when the resource was updated.

    • provider object

      The name of the provider the OAuth2 connection is for

      Hide provider attributes Show provider attributes object
      • name string
      • label string
      • logo_url string
      • authorization_url string
    • access_token_expires_at string

      The expiry date of the access token. If blank, the access token will not expire.

    • refresh_token_expires_at string

      The expiry date of the refresh token. If blank, the refresh token will not expire.

    • refresh_authorization_url string

      The authorization URL to refresh the connection. Only visible when listing all OAuth2 providers.

    • label string

      The user generated label for the OAuth2 connection.
PUT /api/v1/oauth/connections/{oauthConnection_uuid} 
curl \
 --request PUT 'https://api.plannrcrm.com/api/v1/oauth/connections/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"label":"My Fundment Account 1"}'
Request examples 
{
  "label": "My Fundment Account 1"
}
Response examples (200) 
{
  "uuid": "a269a628-4917-4182-a3df-60cc32397078",
  "label": "My Fundment Account 1",
  "provider": {
    "name": "fundment",
    "label": "Fundment",
    "logo_url": "https://api.plannrcrm.com/imgs/fundment-banner.png",
    "authorization_url": "https://api.plannrcrm.com/oauth/fundment/authorize"
  },
  "created_at": "2025-08-07T13:41:47+01:00",
  "updated_at": "2025-08-07T13:41:47+01:00",
  "access_token_expires_at": "2025-08-07T16:41:47.456817Z",
  "refresh_token_expires_at": "2026-08-07T12:41:47.456853Z",
  "refresh_authorization_url": "https://api.plannrcrm.com/oauth/fundment/authorize/927d8271-3e7d-40d9-beb3-95b1dab441f7"
}