Passer au contenu principal
POST
/
marketing
/
campaigns
/
2026-03
/
batch
/
read
Lire un lot de campagnes
curl --request POST \
  --url https://api.hubapi.com/marketing/campaigns/2026-03/batch/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "<string>"
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "assets": {},
      "businessUnits": [
        {
          "id": 123
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "properties": {},
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorisations

Authorization
string
header
requis

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

Paramètres de requête

endDate
string

Date de fin pour récupérer les indicateurs de ressources, au format JJ-MM-AAAA. Cette date est utilisée pour récupérer les indicateurs associés aux ressources pour une période spécifiée. Si elle n'est pas fournie, aucun indicateur de ressources ne sera récupéré. Exemple : 27-01-2024

properties
string[]

Une liste de propriétés séparées par des virgules à afficher dans la réponse. Si l'une des propriétés spécifiées a une valeur vide sur l'objet/les objets demandé(s), elle sera ignorée et ne sera pas affichée dans la réponse. Si ce paramètre est vide, la réponse inclura une carte de propriétés vide. Exemple : hs_name, hs_campaign_status, hs_notes

startDate
string

Date de début pour récupérer les indicateurs de ressources, au format JJ-MM-AAAA. Cette date est utilisée pour récupérer les indicateurs associés aux ressources pour une période spécifiée. Si elle n'est pas fournie, aucun indicateur de ressources ne sera récupéré. Exemple : 20-01-2023

Corps

application/json
inputs
object[]
requis

Un tableau d’objets PublicCampaignReadInput, chacun contenant l’ID d’une campagne à lire. Cette propriété est obligatoire.

Réponse

successful operation

completedAt
string<date-time>
requis

L'horodatage du moment où le traitement de la demande par lots a été terminé.

results
object[]
requis

Un tableau de résultats de l'opération par lot, chacun représentant une campagne publique avec des ressources.

startedAt
string<date-time>
requis

L'horodatage du début du traitement de la requête de lot.

status
enum<string>
requis

Statut actuel du traitement de l'opération par lots, avec les valeurs possibles suivantes : ANNULÉ, TERMINÉ, EN ATTENTE, EN COURS DE TRAITEMENT.

Options disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

Une collection d'URL renvoyant vers des ressources ou de la documentation connexes.

requestedAt
string<date-time>

L'horodatage du moment où la requête de lot a été faite initialement.

Last modified on May 11, 2026