Zum Hauptinhalt springen
PATCH
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
Mettre à jour l'événement marketing par ID externes
curl --request PATCH \
  --url https://api.hubapi.com/marketing/v3/marketing-events/events/{externalEventId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "startDateTime": "2023-11-07T05:31:56Z",
  "customProperties": [
    {
      "sourceId": "",
      "selectedByUser": false,
      "sourceLabel": "",
      "sourceUpstreamDeployable": "<string>",
      "source": "",
      "updatedByUserId": 123,
      "persistenceTimestamp": 123,
      "sourceMetadata": "",
      "dataSensitivity": "",
      "sourceVid": "",
      "unit": "",
      "requestId": "",
      "isEncrypted": false,
      "name": "",
      "useTimestampAsPersistenceTimestamp": true,
      "value": "",
      "selectedByUserTimestamp": 123,
      "timestamp": 123,
      "isLargeValue": true
    }
  ],
  "eventCancelled": true,
  "eventOrganizer": "<string>",
  "eventUrl": "<string>",
  "eventDescription": "<string>",
  "eventName": "<string>",
  "eventType": "<string>",
  "eventCompleted": true,
  "endDateTime": "2023-11-07T05:31:56Z"
}'
{
  "eventOrganizer": "<string>",
  "eventUrl": "<string>",
  "eventType": "<string>",
  "eventCompleted": true,
  "endDateTime": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "startDateTime": "2023-11-07T05:31:56Z",
  "customProperties": [
    {
      "sourceId": "",
      "selectedByUser": false,
      "sourceLabel": "",
      "sourceUpstreamDeployable": "<string>",
      "source": "",
      "updatedByUserId": 123,
      "persistenceTimestamp": 123,
      "sourceMetadata": "",
      "dataSensitivity": "",
      "sourceVid": "",
      "unit": "",
      "requestId": "",
      "isEncrypted": false,
      "name": "",
      "useTimestampAsPersistenceTimestamp": true,
      "value": "",
      "selectedByUserTimestamp": 123,
      "timestamp": 123,
      "isLargeValue": true
    }
  ],
  "eventCancelled": true,
  "eventDescription": "<string>",
  "eventName": "<string>",
  "id": "<string>",
  "objectId": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubGratuit
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubStarter

​
Portées requises

Cette API requiert l’une des portées suivantes :
  • crm.objects.marketing_events.write

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
externalEventId
string
required

L'identifiant de l'événement marketing dans l'application d'événements externe

Query Parameters

​
externalAccountId
string
required

L'ID de compte associé à cet événement marketing dans l'application d'événement externe.

Body

application/json
​
startDateTime
string<date-time>

La date et l'heure de début de l'événement marketing.

​
customProperties
object[]

Une liste de « PropertyValues ». Il peut s'agir de n'importe quel type de noms et de valeurs de propriétés que vous souhaitez. Toutefois, ils doivent déjà exister dans la définition de l'objet « MarketingEvent » du compte HubSpot. S'ils n'existent pas, ils seront filtrés et non définis. Pour ce faire, vous devrez créer un nouveau «  PropertyGroup  » sur l'objet MarketingEvent du compte HubSpot pour votre application spécifique et créer la propriété personnalisée que vous souhaitez suivre sur ce compte HubSpot. Ne créez aucune nouvelle propriété par défaut sur l'objet MarketingEvent, car cela s'appliquerait à tous les comptes HubSpot.

​
eventCancelled
boolean

Indique si l'événement marketing a été annulé. Par défaut, « faux »

​
eventOrganizer
string

Le nom de l'organisateur de l'événement marketing.

​
eventUrl
string

Une URL dans l'application d'événement externe d'où il est possible de gérer l'événement marketing.

​
eventDescription
string

La description de l'événement marketing.

​
eventName
string

Le nom de l'événement marketing.

​
eventType
string

Décrit le type d'événement. Par exemple : « WEBINAR », « CONFERENCE », « WORKSHOP »

​
eventCompleted
boolean
​
endDateTime
string<date-time>

La date et l'heure de fin de l'événement marketing.

Response

successful operation

​
eventOrganizer
string
required

Le nom de l'organisateur de l'événement marketing.

​
createdAt
string<date-time>
required
​
eventName
string
required

Le nom de l'événement marketing.

​
id
string
required
​
updatedAt
string<date-time>
required
​
eventUrl
string

Une URL dans l'application d'événement externe d'où il est possible de gérer l'événement marketing.

​
eventType
string

Le type de l'événement marketing.

​
eventCompleted
boolean
​
endDateTime
string<date-time>

La date et l'heure de fin de l'événement marketing.

​
startDateTime
string<date-time>

La date et l'heure de début de l'événement marketing.

​
customProperties
object[]

Une liste de « PropertyValues ». Il peut s'agir de n'importe quel type de noms et de valeurs de propriétés que vous souhaitez. Toutefois, ils doivent déjà exister dans la définition de l'objet « MarketingEvent » du compte HubSpot. S'ils n'existent pas, ils seront filtrés et non définis. Pour ce faire, vous devrez créer un nouveau «  PropertyGroup » sur l'objet MarketingEvent du compte HubSpot pour votre application spécifique et créer la propriété personnalisée que vous souhaitez suivre sur ce compte HubSpot. Ne créez aucune nouvelle propriété par défaut sur l'objet MarketingEvent, car cela s'appliquerait à tous les comptes HubSpot.

​
eventCancelled
boolean

Indique si l'événement marketing a été annulé.

​
eventDescription
string

La description de l'événement marketing.

​
objectId
string
⌘I