Skip to main content
PATCH
/
crm
/
v3
/
extensions
/
cards-dev
/
{appId}
/
{cardId}
Update a card
curl --request PATCH \
  --url https://api.hubapi.com/crm/v3/extensions/cards-dev/{appId}/{cardId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "actions": {
    "baseUrls": [
      "https://www.example.com/hubspot"
    ]
  },
  "display": {
    "properties": [
      {
        "dataType": "STRING",
        "label": "Pets Name",
        "name": "pet_name"
      }
    ]
  },
  "fetch": {
    "objectTypes": [
      {
        "name": "contacts",
        "propertiesToSend": [
          "email",
          "firstname"
        ]
      }
    ],
    "targetUrl": "https://www.example.com/hubspot/target"
  },
  "title": "PetSpot"
}
'
{
  "actions": {
    "baseUrls": [
      "https://www.example.com/hubspot"
    ]
  },
  "auditHistory": [
    {
      "actionType": "CREATE",
      "applicationId": 123,
      "authSource": "APP",
      "changedAt": 123,
      "initiatingUserId": 123,
      "objectTypeId": 123
    }
  ],
  "display": {
    "properties": [
      {
        "dataType": "BOOLEAN",
        "label": "<string>",
        "name": "<string>",
        "options": [
          {
            "label": "<string>",
            "name": "<string>",
            "type": "DANGER"
          }
        ]
      }
    ]
  },
  "fetch": {
    "objectTypes": [
      {
        "name": "companies",
        "propertiesToSend": [
          "<string>"
        ]
      }
    ],
    "targetUrl": "<string>"
  },
  "id": "<string>",
  "title": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

appId
integer<int32>
required

The id of the app containing the Legacy CRM Card.

cardId
string
required

The id of the app containing the Legacy CRM Card

Body

application/json

Body for a patch with optional fields

actions
object

Configuration for custom user actions on cards.

Example:
{
"baseUrls": ["https://www.example.com/hubspot"]
}
display
object

Configuration for displayed info on a card

fetch
object

Variant of CardFetchBody with fields as optional for patches

title
string

The top-level title for this card. Displayed to users in the CRM UI.

Response

successful operation

actions
object
required

Configuration for custom user actions on cards.

Example:
{
"baseUrls": ["https://www.example.com/hubspot"]
}
auditHistory
object[]
required

A list of actions performed on the card, including creation, deletion, and updates.

display
object
required

Configuration for displayed info on a card

fetch
object
required
id
string
required

The unique id of the card.

title
string
required

The top-level title for this card. Displayed to users in the CRM UI.

createdAt
string<date-time>

The date and time when the card was created.

updatedAt
string<date-time>

The date and time when the card was last updated.

Last modified on March 30, 2026