Skip to main content
POST
/
crm
/
v3
/
extensions
/
cards-dev
/
{appId}
Create a new card
curl --request POST \
  --url https://api.hubapi.com/crm/v3/extensions/cards-dev/{appId} \
  --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 to contain the Legacy CRM Card

Body

application/json

State of card definition to be created

actions
object
required

Configuration for custom user actions on cards.

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

Configuration for displayed info on a card

fetch
object
required

Configuration for this card's data fetch request.

title
string
required

The top-level title for this card, displayed to users in the CRM UI. It is a string.

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