API Flashcards
What authentication method does Marketing Cloud use?
OAuth 2.0
What two parameters should you pass for Authentication?
Client Secret
Client ID
What tasks does the REST API interact with?
Contact Builder
Content Builder
GroupConnect
Journey Builder
MobileConnect and MobilePush
What does the REST API use for its Request and Response bodies?
JSON
What are the timeout values for API calls?
120 seconds for non-tracking operations
300 seconds for tracking and data retrieval
What does the SOAP API use for its Request and Response bodies?
XML
What tasks does the SOAP API interact with?
Automations
Content Creation (classic, not content builder)
Subscribers and Lists
Tracking
Triggered Sends
What are the seven SOAP methods?
Configure (Used to configure an account)
Create (Used to create individual or batches of objects)
Delete (Used to delete individual or batches of objects)
Describe
Execute
Extract
GetSystemStatus
The SOAP API has 263 API objects that we can interact with, name 4 common ones?
Data Extension
Triggered Sends
Automations
ClickEvent
What are the three Data Extension objects?
DataExtention (the actual data extension)
DataExtensionField (a field or attribute)
DataExtentionObject (a row in the data extension)
What three objects need to be defined for a triggered send?
TriggeredSend
TriggeredSendDefinition
Subscribers
What is a ClickEvent object?
An object that contains time, date, URL ID and URL information about a click on a link in an email.
What is a Automation object?
Used to interact with an automation in Automation Studio. AutomationActivity is used to define activities in an automation.
What is the REST API endpoint for Content Builder?
/asset/v1/content/assets
What is the REST API endpoint for Contact Builder?
/contacts/v1/contacts
What is the REST API endpoint for Journey Builder?
/interaction/v1/interactions
What is the REST API endpoint for Triggered Sends?
/messaging/v1/messageDefinitionSends
What is the REST API endpoint for Transactional Sends?
/messaging/v1/emailmm
What is the REST API endpoint for Create Assets?
/asset/v1/content/assets
Requires JSON that contains information like asset type, name and content. Creates an asset with the information in Content Builder
What is the REST API endpoint for Create Folder?
/asset/v1/content/categories
Requires a JSON that contains information to create a folder in a specified location
What is the REST API endpoint for Update/Delete Assets?
/asset/v1/content/assets/{id}
Requires a JSON that contains information to delete or update an existing asset, identified using the asset ID in the URL
What is the REST API endpoint for Create Contact?
/contacts/v1/contacts
Requires a JSON that contains information like contact key, contact ID and attributes.
Creates a contact with the information
What is the REST API endpoint for Delete Contact?
/contacts/v1/contacts/actions/delete?type=keys/ids
Requires a JSON that contains contact keys or ids of the contacts to be deleted
What is the REST API endpoint to fire an entry into a Journey?
/interaction/v1/events
Requires a JSON containing the ContactKey and EventDefinitionKey to fire the event that enters the Contact into a Journey
What is the REST API endpoint to send a triggered email?
/messaging/v1/messageDefinitionSends/{triggeredSendDefinitionId]/send
Sends an email from a Triggered Send Definition. Note that this triggeredSendDefinitionId must be set up first before making this call, otherwise it won’t work
What is the REST API endpoint to get the delivery details of a triggered send?
/messaging/v1/messageDefinitionSends/key:{key}/deliveryRecords
Gets the delivery details of an email sent from a triggered send
