> ## 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 sample card detail response

> Devuelve un ejemplo de respuesta de detalles de tarjeta. Esta es la carga que contiene los detalles de una tarjeta que se mostrarán a un usuario. Una aplicación debe enviar esto en respuesta a la solicitud de recuperación de datos.

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 <div>
      <div className="text-sm mb-2">{translations.description}</div>
      <div className={`grid ${products.length === 1 ? 'grid-cols-1' : 'grid-cols-2'} gap-1.5`}>
        {products.map((product, index) => <div key={index} style={{
    display: 'flex',
    alignItems: 'center'
  }}>
            <img src={product.icon} alt={product.alt} className="w-3.5 h-3.5 mr-1.5 mt-2.5 mb-2.5 flex-shrink-0 align-middle" />
            <span className="font-medium mr-1 text-sm">{product.name} -</span>
            <span className="text-sm">{product.level}</span>
          </div>)}
      </div>
    </div>;
};

<Accordion title="Supported products" defaultOpen="true" icon="cubes">
  <SupportedProducts marketing={true} sales={true} service={true} cms={true} marketingLevel="FREE" salesLevel="FREE" serviceLevel="FREE" cmsLevel="FREE" />
</Accordion>


## OpenAPI

````yaml specs/2026-03/crm-public-app-crm-cards-v2026-03.json GET /crm/extensions/cards-dev/2026-03/sample-response
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/sample-response:
    get:
      tags:
        - Basic
      summary: Obtener respuesta con ejemplo de detalles de la tarjeta
      description: >-
        Devuelve un ejemplo de respuesta de detalles de tarjeta. Esta es la
        carga que contiene los detalles de una tarjeta que se mostrarán a un
        usuario. Una aplicación debe enviar esto en respuesta a la solicitud de
        recuperación de datos.
      operationId: >-
        get-/crm/extensions/cards-dev/2026-03/sample-response_getCardsSampleResponse
      parameters: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegratorCardPayloadResponse'
        default:
          $ref: '#/components/responses/Error'
          description: ''
components:
  schemas:
    IntegratorCardPayloadResponse:
      required:
        - responseVersion
        - sections
        - totalCount
      type: object
      properties:
        allItemsLinkUrl:
          type: string
          description: >-
            URL a una página que el integrador construyó y que muestra todos los
            detalles de esta tarjeta. Esta URL se mostrará a los usuarios bajo
            un enlace "Ver más [x]" si hay más de cinco elementos en la
            respuesta, donde "[x]" es el valor de "itemLabel".
        cardLabel:
          type: string
          description: >-
            La etiqueta que se utilizará para el enlace "allItemsLinkUrl" (por
            ejemplo, "Ver más tickets"). Si no se especifica, se utilizará el
            título de la tarjeta.
        responseVersion:
          type: string
          description: La versión numérica de la respuesta.
          enum:
            - v1
            - v3
        sections:
          type: array
          description: Una lista de hasta cinco subcategorías de tarjetas válidas.
          items:
            $ref: '#/components/schemas/IntegratorObjectResult'
        topLevelActions:
          $ref: '#/components/schemas/TopLevelActions'
        totalCount:
          type: integer
          description: >-
            El número total de propiedades de tarjeta que se enviarán en esta
            respuesta.
          format: int32
    IntegratorObjectResult:
      required:
        - actions
        - id
        - title
        - tokens
      type: object
      properties:
        actions:
          type: array
          description: >-
            Una lista de acciones asociadas a la tarjeta, que puede incluir
            hooks de acción, hooks de acción de confirmación o iframes.
          items:
            oneOf:
              - $ref: '#/components/schemas/ActionHookActionBody'
              - $ref: '#/components/schemas/IFrameActionBody'
        id:
          type: string
          description: El identificador único de la tarjeta.
        linkUrl:
          type: string
          description: Una URL que se usa en el título 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.
        tokens:
          type: array
          description: >-
            Una colección de tokens que representan propiedades específicas
            relacionadas con la tarjeta.
          items:
            $ref: '#/components/schemas/ObjectToken'
    TopLevelActions:
      required:
        - secondary
      type: object
      properties:
        primary:
          description: >-
            Define la acción principal de una tarjeta, que puede ser un hook de
            acción o un iframe.
          oneOf:
            - $ref: '#/components/schemas/ActionHookActionBody'
            - $ref: '#/components/schemas/IFrameActionBody'
        secondary:
          type: array
          description: >-
            Especifica una lista de acciones secundarias para una tarjeta, cada
            una de las cuales puede ser un hook de acción o un iframe.
          items:
            oneOf:
              - $ref: '#/components/schemas/ActionHookActionBody'
              - $ref: '#/components/schemas/IFrameActionBody'
        settings:
          $ref: '#/components/schemas/IFrameActionBody'
    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
    ActionHookActionBody:
      title: ACTION_HOOK
      required:
        - httpMethod
        - propertyNamesIncluded
        - type
        - url
      type: object
      properties:
        confirmation:
          $ref: '#/components/schemas/ActionConfirmationBody'
        httpMethod:
          type: string
          description: >-
            El método HTTP que se utilizará al hacer la llamada, que puede
            definirse como GET, POST, PUT, DELETE o PATCH. Si utilizas GET o
            DELETE
          enum:
            - CONNECT
            - DELETE
            - GET
            - HEAD
            - OPTIONS
            - PATCH
            - POST
            - PUT
            - TRACE
        label:
          type: string
          description: >-
            La etiqueta de esta propiedad como te gustaría que se mostrara a los
            usuarios.
        propertyNamesIncluded:
          type: array
          description: >-
            Una lista de nombres de propiedades que se incluirán en la acción.
            Consulta la documentación para obtener más información.
          items:
            type: string
        type:
          type: string
          description: El tipo de estado.
          default: ACTION_HOOK
          enum:
            - ACTION_HOOK
        url:
          type: string
          description: >-
            El punto de terminación de la URL al que se llamará cuando se
            desencadene la acción.
      x-hubspot-sub-type-impl: true
    IFrameActionBody:
      title: IFRAME
      required:
        - height
        - propertyNamesIncluded
        - type
        - url
        - width
      type: object
      properties:
        height:
          type: integer
          description: La altura del iframe en píxeles.
          format: int32
        label:
          type: string
          description: >-
            La etiqueta de esta propiedad como te gustaría que se mostrara a los
            usuarios.
        propertyNamesIncluded:
          type: array
          description: >-
            Una lista de nombres de propiedades que se incluirán en la URL del
            iframe.
          items:
            type: string
        type:
          type: string
          description: El tipo de estado.
          default: IFRAME
          enum:
            - IFRAME
        url:
          type: string
          description: >-
            El punto de terminación de la URL que se cargará en el iframe cuando
            se desencadene.
        width:
          type: integer
          description: La anchura del iframe en píxeles.
          format: int32
      x-hubspot-sub-type-impl: true
    ObjectToken:
      required:
        - value
      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.
        value:
          type: string
          description: El valor de la propiedad
    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
    ActionConfirmationBody:
      required:
        - cancelButtonLabel
        - confirmButtonLabel
        - prompt
      type: object
      properties:
        cancelButtonLabel:
          type: string
          description: La etiqueta del botón que cancela la acción.
        confirmButtonLabel:
          type: string
          description: La etiqueta del botón que confirma la acción.
        prompt:
          type: string
          description: El mensaje que se muestra al usuario para confirmar la acción.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'

````