Create an API Request /Créer une demande d’API

Learning Objectives /Objectifs de formation

After completing this unit, you’ll be able to: / Une fois cette unité terminée, vous pourrez :

• Create a Marketing Cloud contact using the REST API. /Créez un contact Marketing Cloud à l’aide de l’API REST.
• Validate your Marketing Cloud developer environment setup. /Validez la configuration de votre environnement de développeur Marketing Cloud.

Hello, World! /Bonjour le monde!

No developer learning experience is complete without a “Hello, World!” project to put your new skills to the test! /Aucune expérience d’apprentissage de développeur n’est complète sans un projet “Bonjour, le monde!” pour mettre vos nouvelles compétences à l’épreuve!

Now that you created a package in Marketing Cloud and understand where to get the authentication credentials, let’s validate your development environment setup by creating a contact through the REST API. /Maintenant que vous avez créé un package dans Marketing Cloud et que vous savez où obtenir les informations d’authentification, validons la configuration de votre environnement de développement en créant un contact via l’API REST.

JSON Parameters /Paramètres JSON

Before we jump in and create a contact, let’s review the parameters for this simplified example of using this route. /Avant de commencer à créer un contact, examinons les paramètres de cet exemple simplifié d’utilisation de ce chemin.

Name	Type	Required	Description
contactKey	string	Yes	Primary address for the contact /Adresse principale du contact
attributeSets	array	Yes	Array of information used to create a new contact /Tableau d’informations utilisé pour créer un nouveau contact
attributeSets.name	string	Yes	Name of attribute group to which to add the contact information /Nom du groupe d’attributs auquel ajouter les informations de contact
attributeSets.values	array	No	Name and value pairs indicating the attribute and applicable value /Paires de noms et de valeurs indiquant l’attribut et la valeur applicable

Note /Remarque

To see a complete list of what this API route can do, check out the Create Contacts REST reference on Salesforce Developers. /Pour voir une liste complète de ce que peut faire cet itinéraire d’API, consultez la référence REST dans la documentation en ligne Salesforce développeurs.

Create the API Request /Créer la demande d’API

Follow these steps to create a contact in Marketing Cloud using the REST API. You need access to Marketing Cloud and the package you created in the last unit. /Suivez ces étapes pour créer un contact dans Marketing Cloud à l’aide de l’API REST. Vous devez avoir accès à Marketing Cloud et au package que vous avez créé dans la dernière unité.

In your preferred API development tool, construct a request to create a new contact.  /Dans votre outil de développement d’API préféré, créez une demande pour créer un nouveau contact.

1. Use this sample code and substitute your REST Base URI in Host and your access token in Authorization. Remember, you can find this information under the component details of your installed package. /Utilisez cet exemple de code et remplacez votre URI de base REST dans l’hôte et votre jeton d’accès dans l’autorisation. N’oubliez pas que vous pouvez trouver ces informations sous les détails des composants de votre package installé.
2. Include a value for contactKey with a valid subdomain. The value for HTML Enabled is required. /Incluez une valeur pour contactKey avec un sous-domaine valide. La valeur pour HTML activé est obligatoire.
3. You can enter your own email address rather than using your own sample code. /Vous pouvez entrer votre propre adresse e-mail plutôt que d’utiliser votre propre exemple de code.

Note /Remarque

Each call accepts only one instance of each attribute set. /Chaque appel n’accepte qu’une seule instance de chaque ensemble d’attributs.

Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /contacts/v1/contacts
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
{
"contactKey": "example@salesforce.com",
"attributeSets": [{
"name": "Email Addresses",
"items": [{
"values": [{
"name": "Email Address",
"value": "example@salesforce.com"
},
{
"name": "HTML Enabled",
"value": true
}]
}]
}]
}

Now that the request is created, send the request to Marketing Cloud to create a contact. /Maintenant que la demande est créée, envoyez-la à Marketing Cloud pour créer un contact.

Validate the Request /Valider la demande

Let’s confirm that your new contact now exists in Marketing Cloud. It can take a couple hours to receive a response, so don’t panic if you don’t see it right away. There are two ways you can validate your work. /Confirmons que votre nouveau contact existe désormais dans Marketing Cloud. Cela peut prendre quelques heures pour recevoir une réponse, alors ne paniquez pas si vous ne le voyez pas tout de suite. Il existe deux façons de valider votre travail.

First, you receive a response similar to this in your development tool. /Tout d’abord, vous recevez une réponse similaire à celle-ci dans votre outil de développement.

200 (OK)
Content-Type: application/json
{
    "operationStatus": "OK",
    "rowsAffetcted": 1,
    "contactKey": "example@salesforce.com",
    "contactId": 12345678,
    "contactTypeID": 0,
    "isNewContactKey": false,
    "requestServiceMessageID": "8b51b524-28c1-46fc-9a44-02fca5b0a08c",
    "hasErrors": false,
    "resultMessages": [],
    "serviceMessageID": "80676c59-ceb9-48aa-ad35-81e150094a17"

Second, you can navigate to Contact Builder in Marketing Cloud to confirm that your contact exists. /Deuxièmement, vous pouvez accéder à Contact Builder dans Marketing Cloud pour confirmer que votre contact existe.

1. In Marketing Cloud Contact Builder, click All Contacts. /Dans Marketing Cloud Contact Builder, cliquez sur Tous les contacts.
2. Search for the contact you created. /Recherchez le contact que vous avez créé.
3. Click the contact to review the contact data against your API request. /Cliquez sur le contact pour examiner les données de contact par rapport à votre demande d’API.

Congratulations! You created your first successful Marketing Cloud API reque /Toutes nos félicitations! Vous avez créé votre première demande d’API Marketing Cloud réussie!

Note /Remarque

Not able to validate your work? Learn how to Handle Errors in REST API on Salesforce Developers. /Vous ne pouvez pas valider votre travail? Découvrez comment gérer les erreurs dans l’API REST sur les développeurs Salesforce.

What’s Next? /Et après?

You learned a little about the Marketing Cloud APIs, SDKs, and programmatic languages available to use as you blaze trails with Marketing Cloud. /Vous avez appris un peu les API Marketing SDK, les kits de développement logiciel (SDK) et les langages de programmation disponibles à utiliser lorsque vous parcourez les pistes avec Marketing Cloud.

You gained some administrator basics, such as the overall Marketing Cloud account structure (tenants, MIDs, endpoints, business units) and how users and permissions determine access. /Vous avez acquis des notions de base sur l’administrateur, telles que la structure globale du compte Marketing Cloud (locataires, MID, points de terminaison, unités commerciales) et la manière dont les utilisateurs et les autorisations déterminent l’accès.

You even set up your developer environment and validated it by creating a Contact in Marketing Cloud. /Vous avez même configuré votre environnement de développeur et l’avez validé en créant un contact dans Marketing Cloud.

So, what’s next? When you’re ready to start coding, you can dive deeper into Marketing Cloud developer resources on the Marketing Cloud Developer Center. /Alors, quelle est la prochaine étape? Lorsque vous êtes prêt à commencer le codage, vous pouvez approfondir via les ressources des développeurs Marketing Cloud sur le Centre des développeurs Marketing Cloud.

Join our huge community of developers through that site, where you can share ideas, join developer groups, read success stories, and more.  / Rejoignez notre immense communauté de développeurs via ce site, où vous pouvez partager des idées, rejoindre des groupes de développeurs, lire des histoires de réussite, etc.

Resources /Ressources

• Content Builder Block SDK (Trailhead module)
• GitHub Repository – Salesforce Marketing Cloud Platform
• Handle Errors in REST API
• Marketing Cloud Developer Center
• Marketing Cloud REST API – Create Contacts