Crear una tarjeta nueva

Define una nueva tarjeta que se activará en una cuenta cuando se instale esta aplicación.

POST /crm/v3/extensions/cards-dev/{appId}

Crear una tarjeta nueva

cURL

curl --request POST \
  --url 'https://api.hubapi.com/crm/v3/extensions/cards-dev/{appId}?hapikey=' \
  --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"
}
'

201

{
  "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"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.

Marketing HubGratuito

Sales HubGratuito

Service HubGratuito

Content HubGratuito

Autorizaciones

hapikey · string · query · requerido

Parámetros de ruta

appId · integer<int32> · requerido

Cuerpo

application/json

State of card definition to be created

actions · object · requerido

Configuration for custom user actions on cards.

Show child attributes

Ejemplo:

{
  "baseUrls": ["https://www.example.com/hubspot"]
}

display · object · requerido

Configuration for displayed info on a card

Show child attributes

fetch · object · requerido

Configuration for this card's data fetch request.

Show child attributes

title · string · requerido

El título de nivel superior de esta tarjeta. Se muestra a los usuarios en la UI del CRM.

Respuesta

201

application/json

successful operation

actions · object · requerido

Configuration for custom user actions on cards.

Show child attributes

Ejemplo:

{
  "baseUrls": ["https://www.example.com/hubspot"]
}

auditHistory · object[] · requerido

Una lista de acciones realizadas en la tarjeta, que incluyen creación, eliminación y actualizaciones.

Show child attributes

display · object · requerido

Configuration for displayed info on a card

Show child attributes

fetch · object · requerido

Show child attributes

id · string · requerido

El ID único de la tarjeta.

title · string · requerido

El título de nivel superior de esta tarjeta. Se muestra a los usuarios en la UI del CRM.

createdAt · string<date-time>

La fecha y hora en que se creó la tarjeta.

updatedAt · string<date-time>

La fecha y hora en que se actualizó por última vez la tarjeta.