Update an OAuth2 connection

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

      Additional properties are allowed.

    • 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": "1b4bb605-6f76-4aed-a4d0-e7b3723b806a",
  "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-02-20T10:13:06+00:00",
  "updated_at": "2025-02-20T10:13:06+00:00",
  "access_token_expires_at": "2025-02-20T14:13:06.511683Z",
  "refresh_token_expires_at": "2026-02-20T10:13:06.511720Z",
  "refresh_authorization_url": "https://plannr.valet/oauth/fundment/authorize/0326b0f9-4894-491d-9bdd-fc7f1d07e105"
}