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": "7088230c-547a-42ed-a529-8e54a5863105",
  "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-27T17:31:27+01:00",
  "updated_at": "2025-08-27T17:31:27+01:00",
  "access_token_expires_at": "2025-08-27T20:31:27.928096Z",
  "refresh_token_expires_at": "2026-08-27T16:31:27.928110Z",
  "refresh_authorization_url": "https://api.plannrcrm.com/oauth/fundment/authorize/effca07d-2392-43b5-b93a-901a5baf8f24"
}