> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Get a card.
> Devuelve la definición de una tarjeta con el ID especificado.
export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => {
const translations = {
header: "Productos compatibles",
description: "Se requiere uno de los siguientes productos o productos de ediciones superiores.",
productNames: {
marketing: "Marketing Hub",
sales: "Sales Hub",
service: "Service Hub",
cms: "Content Hub"
},
tiers: {
free: "Gratuito",
starter: "Starter",
professional: "Pro",
enterprise: "Enterprise"
}
};
const translateTier = tier => {
if (!tier) return '';
const lowerTier = tier.toLowerCase();
return translations.tiers[lowerTier] || tier;
};
const products = [{
name: marketing ? translations.productNames.marketing : '',
level: translateTier(marketingLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
alt: "Marketing Hub"
}, {
name: sales ? translations.productNames.sales : '',
level: translateTier(salesLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
alt: "Sales Hub"
}, {
name: service ? translations.productNames.service : '',
level: translateTier(serviceLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
alt: "Service Hub"
}, {
name: cms ? translations.productNames.cms : '',
level: translateTier(cmsLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
alt: "Content Hub"
}].filter(product => product.name && product.level);
if (products.length === 0) return null;
return
{translations.description}
{products.map((product, index) =>
{product.name} -{product.level}
)}
;
};
## OpenAPI
````yaml specs/2026-03/crm-public-app-crm-cards-v2026-03.json GET /crm/extensions/cards-dev/2026-03/{appId}/{cardId}
openapi: 3.0.1
info:
title: Tarjetas del Crm de aplicación pública
description: Basepom for all HubSpot Projects
version: 2026-03
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
x-hubspot-api-use-case: >-
Agrega una tarjeta personalizada a los registros de contacto que muestre
datos de tu software externo de seguimiento de errores.
x-hubspot-introduction: >-
Crea tarjetas personalizadas para datos de sistemas externos en los
registros del CRM. Requiere una aplicación pública. Estas tarjetas del CRM
son diferentes de las extensiones de UI que puedes crear con los proyectos.
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
paths:
/crm/extensions/cards-dev/2026-03/{appId}/{cardId}:
get:
tags:
- Basic
summary: Obtén una tarjeta.
description: Devuelve la definición de una tarjeta con el ID especificado.
operationId: get-/crm/extensions/cards-dev/2026-03/{appId}/{cardId}_getById
parameters:
- name: appId
in: path
description: >-
El appId de la aplicación que contiene las tarjetas del CRM
anteriores
required: true
style: simple
explode: false
schema:
type: integer
format: int32
- name: cardId
in: path
description: El ID de la tarjeta del CRM anterior
required: true
style: simple
explode: false
schema:
type: string
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/PublicCardResponse'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- developers-read
- oauth2:
- private-apps-read
components:
schemas:
PublicCardResponse:
required:
- actions
- auditHistory
- display
- fetch
- id
- title
type: object
properties:
actions:
$ref: '#/components/schemas/CardActions'
auditHistory:
type: array
description: >-
Una lista de acciones realizadas en la tarjeta, que incluyen
creación, eliminación y actualizaciones.
items:
$ref: '#/components/schemas/CardAuditResponse'
createdAt:
type: string
description: La fecha y hora en que se creó la tarjeta.
format: date-time
display:
$ref: '#/components/schemas/CardDisplayBody'
fetch:
$ref: '#/components/schemas/PublicCardFetchBody'
id:
type: string
description: El ID único de la tarjeta.
title:
type: string
description: >-
El título de nivel superior de esta tarjeta. Se muestra a los
usuarios en la UI del CRM.
updatedAt:
type: string
description: La fecha y hora en que se actualizó por última vez la tarjeta.
format: date-time
CardActions:
required:
- baseUrls
type: object
properties:
baseUrls:
type: array
description: >-
Una lista de prefijos de URL que se aceptarán para las URL de acción
de tarjeta. Si tu respuesta de recuperación de datos incluye una URL
de acción que no comienza con uno de estos valores, se producirá un
error y la tarjeta no se mostrará.
items:
type: string
CardAuditResponse:
required:
- actionType
- applicationId
- authSource
- changedAt
- initiatingUserId
- objectTypeId
type: object
properties:
actionType:
type: string
description: >-
El tipo de acción realizada, con estos posibles valores: CREATE,
DELETE, UPDATE.
enum:
- CREATE
- DELETE
- UPDATE
applicationId:
type: integer
description: El ID de la aplicación asociada a la tarjeta.
format: int32
authSource:
type: string
description: >-
La fuente de autenticación de la acción, con estos posibles valores:
APP, EXTERNAL, INTERNAL.
enum:
- APP
- EXTERNAL
- INTERNAL
changedAt:
type: integer
description: La marca de tiempo que indica cuándo se produjo el cambio.
format: int64
initiatingUserId:
type: integer
description: El ID del usuario que inició la acción.
format: int32
objectTypeId:
type: integer
description: El ID de la tarjeta.
format: int64
CardDisplayBody:
required:
- properties
type: object
properties:
properties:
type: array
description: >-
Propiedades de visualización de tarjeta. Se renderizarán como pares
"etiqueta : valor" en la UI de tarjeta. Para obtener más detalles,
consulta la [tarjeta de ejemplo](#) en los documentos de resumen.
items:
$ref: '#/components/schemas/CardDisplayProperty'
PublicCardFetchBody:
required:
- objectTypes
- targetUrl
type: object
properties:
objectTypes:
type: array
description: >-
Una secuencia de tipos de objetos de CRM donde se debe mostrar esta
tarjeta. HubSpot llamará a tu URL de destino cada vez que un usuario
visite una página de registro de los tipos definidos aquí.
items:
$ref: '#/components/schemas/CardObjectTypeBody'
targetUrl:
type: string
description: >-
URL a un punto de terminación de API de servicio que responderá con
detalles de esta tarjeta. HubSpot llamará a este punto cada vez que
un usuario visite una página de registro del CRM donde se debe
mostrar esta tarjeta.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: La categoría del error
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Contexto de la condición de error
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Un identificador único para la solicitud. Incluye este valor con
cualquier informe de error o ticket de asistencia.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: información adicional acerca del error
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a las URI asociadas que contienen
documentación sobre el error o los pasos recomendados para
solucionarlo
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede
example: An error occurred
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
CardDisplayProperty:
required:
- dataType
- label
- name
- options
type: object
properties:
dataType:
type: string
description: Tipo de datos que esta propiedad representa.
enum:
- BOOLEAN
- CURRENCY
- DATE
- DATETIME
- EMAIL
- LINK
- NUMERIC
- STATUS
- STRING
label:
type: string
description: >-
La etiqueta de esta propiedad como te gustaría que se mostrara a los
usuarios.
name:
type: string
description: >-
Un identificador interno de esta propiedad. Este valor debe ser
único TODO.
options:
type: array
description: >-
Una secuencia de opciones disponibles que se pueden mostrar. Solo se
utiliza cuando "dataType" es "ESTADO".
items:
$ref: '#/components/schemas/DisplayOption'
CardObjectTypeBody:
required:
- name
- propertiesToSend
type: object
properties:
name:
type: string
description: Un tipo de objeto de CRM donde se debe mostrar esta tarjeta.
enum:
- companies
- contacts
- deals
- marketing_events
- tickets
propertiesToSend:
type: array
description: >-
Una secuencia de propiedades que deben enviarse a la URL de destino
de esta tarjeta cuando se realiza la solicitud de recuperación de
datos. Deben ser propiedades válidas para el tipo de objeto de CRM
correspondiente.
items:
type: string
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: El código de estado asociado al detalle del error
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Contexto de la condición de error
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: El nombre del campo o parámetro en el que se encontró el error.
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error
DisplayOption:
required:
- label
- name
- type
type: object
properties:
label:
type: string
description: El texto que se mostrará a los usuarios para esta opción.
name:
type: string
description: Nombre único compatible con JSON para la opción.
type:
type: string
description: El tipo de estado.
enum:
- DANGER
- DEFAULT
- INFO
- SUCCESS
- WARNING
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
developers-read: ''
developers-write: ''
private-apps-read: ''
````
{product.name} -
{product.level}
)}