Update an OAuth2 connection

PUT /api/v1/oauth/connections/{oauthConnection_uuid}
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 \
 -X PUT https://api.plannrcrm.com/api/v1/oauth/connections/oauthConnection_uuid \
 -H "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -d '{"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": "a83a51f0-4cae-4678-99c9-ff804525f588",
  "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-01-17T11:18:33+00:00",
  "updated_at": "2025-01-17T11:18:33+00:00",
  "access_token_expires_at": "2025-01-17T15:18:33.545053Z",
  "refresh_token_expires_at": "2026-01-17T11:18:33.545089Z",
  "refresh_authorization_url": "https://plannr.valet/oauth/fundment/authorize/5809186e-f6e7-4507-aa06-9fa403b10f13"
}