Marketing App Extensions
Set up the metadata for extensions and activity types.
Use these endpoints to set up an extension.
| Endpoint | Description |
|---|---|
MarketingAppExtension | The metadata that defines the third-party application. |
MarketingAppExtensionAssignment | The relationship between the extension and a business unit. This object determines which business unit to pass data to and from. |
PardotTenant | The metadata for the business unit. Use this endpoint to identify when you create a MarketingAppExtensionAssignment. |
Set up an extension to represent a third-party app. In this example, we set up a webinar extension and assign it to the HappyHomeTX business unit.
- Authenticate to the Salesforce API.
- Make a request to create an extension for a webinar service and set IsActive to true. We recommend naming it after the service to make it easy to recognize the source. Here is an example request.
Response:
Next, assign the extension to the business unit you want to pass data to or from. This step is required even if you have only one business unit.
- Use query to find your PardotTenant ID. This value is your business unit ID. You can also find this ID in Setup under Business Unit Setup.
The response includes IDs for all of the business units in your accounts.
- To assign the extension, send a POST request to the
/tooling/objects/MarketingAppExtAssignmentendpoint. In the request body, include the tenant ID as the value of theParentIdproperty, and the app ID as the value of theMarketingAppExtensionIdproperty.
A successful request returns a 201 Created response.