Skip to main content
POST
/
crm
/
extensions
/
cards-dev
/
2026-03
/
{appId}
Create a new card
curl --request POST \
  --url https://api.hubapi.com/crm/extensions/cards-dev/2026-03/{appId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "actions": {
    "baseUrls": [
      "<string>"
    ]
  },
  "display": {
    "properties": [
      {
        "dataType": "BOOLEAN",
        "label": "<string>",
        "name": "<string>",
        "options": [
          {
            "label": "<string>",
            "name": "<string>",
            "type": "DANGER"
          }
        ]
      }
    ]
  },
  "fetch": {
    "cardType": "EXTERNAL",
    "objectTypes": [
      {
        "name": "companies",
        "propertiesToSend": [
          "<string>"
        ]
      }
    ],
    "targetUrl": "<string>",
    "serverlessFunction": "<string>"
  },
  "title": "<string>"
}
'
{
  "actions": {
    "baseUrls": [
      "<string>"
    ]
  },
  "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"
}

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

Body

application/json
actions
object
required
display
object
required
fetch
object
required
title
string
required

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

Response

successful operation

actions
object
required
auditHistory
object[]
required

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

display
object
required
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 April 13, 2026