---
title: "Create a new card"
method: POST
path: "/crm/extensions/cards-dev/2026-03/{appId}"
tags: ["Basic"]
---

# Create a new card

`POST /crm/extensions/cards-dev/2026-03/{appId}`

Defines a new card that will become active on an account when this app is installed.

## Path parameters

- `appId` integer, required

## Request body

- CrmExtensionsCardsDevCardCreateRequest
  - `actions` CrmExtensionsCardsDevCardActions, required
    - `baseUrls` string[], required — A list of URL prefixes that will be accepted for card action URLs. If your data fetch response includes an action URL that doesn't begin with one of these values, it will result in an error and the card will not be displayed.
  - `display` CrmExtensionsCardsDevCardDisplayBody, required
    - `properties` CrmExtensionsCardsDevCardDisplayProperty[], required — Card display properties. These will will be rendered as "label : value" pairs in the card UI. See the [example card](#) in the overview docs for more details.
      - `dataType` 'BOOLEAN' | 'CURRENCY' | 'DATE' | 'DATETIME' | 'EMAIL' | 'LINK' | 'NUMERIC' | 'STATUS' | 'STRING', required — Type of data represented by this property.
      - `label` string, required — The label for this property as you'd like it displayed to users.
      - `name` string, required — An internal identifier for this property. This value must be unique TODO.
      - `options` CrmExtensionsCardsDevDisplayOption[], required — An array of available options that can be displayed. Only used in when `dataType` is `STATUS`.
        - `label` string, required — The text that will be displayed to users for this option.
        - `name` string, required — JSON-friendly unique name for option.
        - `type` 'DANGER' | 'DEFAULT' | 'INFO' | 'SUCCESS' | 'WARNING', required — The type of status.
  - `fetch` CrmExtensionsCardsDevCardFetchBody, required
    - `cardType` 'EXTERNAL' | 'SERVERLESS', required — A deprecated field to determine the type of card returned.
    - `objectTypes` CrmExtensionsCardsDevCardObjectTypeBody[], required — An array of CRM object types where this card should be displayed. HubSpot will call your data fetch URL whenever a user visits a record page of the types defined here.
      - `name` 'companies' | 'contacts' | 'deals' | 'marketing_events' | 'tickets', required — A CRM object type where this card should be displayed.
      - `propertiesToSend` string[], required — An array of properties that should be sent to this card's target URL when the data fetch request is made. Must be valid properties for the corresponding CRM object type.
    - `serverlessFunction` string — A deprecated field to specify serverless functionality with the card
    - `targetUrl` string, required — URL to a service endpoints that will respond with card details. HubSpot will call this endpoint each time a user visits a CRM record page where this card should be displayed.
  - `title` string, required — The top-level title for this card. Displayed to users in the CRM UI.

## Response `201`

successful operation

- CrmExtensionsCardsDevPublicCardResponse
  - `actions` CrmExtensionsCardsDevCardActions, required
    - `baseUrls` string[], required — A list of URL prefixes that will be accepted for card action URLs. If your data fetch response includes an action URL that doesn't begin with one of these values, it will result in an error and the card will not be displayed.
  - `auditHistory` CrmExtensionsCardsDevCardAuditResponse[], required — A list of actions performed on the card, including creation, deletion, and updates.
    - `actionType` 'CREATE' | 'DELETE' | 'UPDATE', required — The type of action performed, with possible values: CREATE, DELETE, UPDATE.
    - `applicationId` integer, required — The ID of the application associated with the card.
    - `authSource` 'APP' | 'EXTERNAL' | 'INTERNAL', required — The source of authentication for the action, with possible values: APP, EXTERNAL, INTERNAL.
    - `changedAt` integer, required — The timestamp indicating when the change occurred.
    - `initiatingUserId` integer, required — The ID of the user who initiated the action.
    - `objectTypeId` integer, required — The ID of the card.
  - `createdAt` string, date-time — The date and time when the card was created.
  - `display` CrmExtensionsCardsDevCardDisplayBody, required
    - `properties` CrmExtensionsCardsDevCardDisplayProperty[], required — Card display properties. These will will be rendered as "label : value" pairs in the card UI. See the [example card](#) in the overview docs for more details.
      - `dataType` 'BOOLEAN' | 'CURRENCY' | 'DATE' | 'DATETIME' | 'EMAIL' | 'LINK' | 'NUMERIC' | 'STATUS' | 'STRING', required — Type of data represented by this property.
      - `label` string, required — The label for this property as you'd like it displayed to users.
      - `name` string, required — An internal identifier for this property. This value must be unique TODO.
      - `options` CrmExtensionsCardsDevDisplayOption[], required — An array of available options that can be displayed. Only used in when `dataType` is `STATUS`.
        - `label` string, required — The text that will be displayed to users for this option.
        - `name` string, required — JSON-friendly unique name for option.
        - `type` 'DANGER' | 'DEFAULT' | 'INFO' | 'SUCCESS' | 'WARNING', required — The type of status.
  - `fetch` CrmExtensionsCardsDevPublicCardFetchBody, required
    - `objectTypes` CrmExtensionsCardsDevCardObjectTypeBody[], required — An array of CRM object types where this card should be displayed. HubSpot will call your target URL whenever a user visits a record page of the types defined here.
      - `name` 'companies' | 'contacts' | 'deals' | 'marketing_events' | 'tickets', required — A CRM object type where this card should be displayed.
      - `propertiesToSend` string[], required — An array of properties that should be sent to this card's target URL when the data fetch request is made. Must be valid properties for the corresponding CRM object type.
    - `targetUrl` string, required — URL to a service endpoint that will respond with details for this card. HubSpot will call this endpoint each time a user visits a CRM record page where this card should be displayed.
  - `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.
  - `updatedAt` string, date-time — The date and time when the card was last updated.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)