Update an OAuth2 connection

PUT /api/v1/oauth/connections/{oauthConnection_uuid}
Personal access token & O auth2
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

    • 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/oauthConnection_uuid' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --data '{"label":"My Fundment Account 1"}'
Request examples 
# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json

# Payload
{
  "label": "My Fundment Account 1"
}
Response examples (200) 
{
  "uuid": "15f856f8-d676-4fe2-a81c-e1566e779687",
  "label": "My Fundment Account 1",
  "provider": {
    "name": "fundment",
    "label": "Fundment",
    "logo_url": "https://api.plannrcrm.com/imgs/fundment-banner.png",
    "authorization_url": "https://plannr.valet/oauth/fundment/authorize"
  },
  "created_at": "2025-05-14T18:27:16+01:00",
  "updated_at": "2025-05-14T18:27:16+01:00",
  "access_token_expires_at": "2025-05-14T21:27:16.717353Z",
  "refresh_token_expires_at": "2026-05-14T17:27:16.717391Z",
  "refresh_authorization_url": "https://plannr.valet/oauth/fundment/authorize/aff2ec46-32a6-4844-951d-7fef5370a5c4"
}