You can use the **Send Custom Event** node to transmit any event to Facebook. As a result, you'll be able to create an analysis in Facebook or create a new Custom Audience based on those events. ## Prerequisites --- - [Create a Pixel in Facebook](https://developers.facebook.com/docs/facebook-pixel). - [Generate an access token in Facebook](https://developers.facebook.com/docs/marketing-api/collaborative-ads/managed-partner-ads/api-guide/prerequisites/generate-access-token-system-user). ## Node configuration --- 1. Click the node. 2. Click **Select connection**. 3. From the dropdown list, select the connection. If you haven't established a connection yet, see [Create a connection](/docs/automation/integration/facebook/send-custom-event#create-a-connection). ### Create a connection After you generate a system access token in Facebook, use it a node to establish a connection. 1. At the bottom of the **Select connection** dropdown list, click **Add connection**. 2. In the **Access token** field, enter the app access token from Facebook.
You can read more about access tokens in [Facebook documentation](https://developers.facebook.com/docs/marketing-api/conversions-api/get-started/#access-token).
3. Click **Next**. 4. In the **Connection name** field, enter the name for the access token you generated. 5. Click **Apply**. **Result**: A connection is created and selected. ### Define the integration settings
A blank configuration form in Send Custom Event (Facebook)
A blank configuration form in Send Custom Event (Facebook)
Fields marked with the Snippet icon icon accept [snippets](/docs/assets/snippets) or [inserts](/developers/inserts). This integration allows usage of profile-related inserts.
1. In the **Graph API version** field, enter the currently used Facebook API version. You can find information about the currently used API version in the Facebook documentation. 2. In the **Meta Pixel** field, enter the identifier of the Pixel you use in Facebook. You can find information about how to find the ID of the Pixel in the Facebook documentation. 4. In the **Event data** field, enter your event body. Different types of events may require different data in the request body. Refer to [Facebook developer documentation](https://developers.facebook.com/docs/marketing-api/conversions-api).
Read the article about the [Automation inserts](/developers/inserts/automation).
5. Confirm by clicking **Apply**. **Result**: When the Send Custom Event node is executed, a [`facebook.sendCustomEvent` event](/docs/assets/events/event-reference/integration#facebooksendcustomevent) is generated on the activity list of the profile who is the actor in the workflow. ### Test integration --- You can run a test request. If the request body contains a dynamic reference to a profile attribute and/or an event data from preceding nodes, then you can define the context using [test profile data](/docs/settings/configuration/test-profiles).
Complete description of the feature is available in [Testing outgoing integrations](/docs/automation/test-requests-for-outgoing-integrations).
1. In the **Test integration** section, click **Send test request**. **Result**: A test request builder opens. If: - a request body contains dynamic references, the request preview appears after you select the context of test profiles and events. - a request body contains static data, the preview of the body request appears immediately.
An empty test request builder
An empty test request builder
2. If your request contains dynamic references (otherwise, the options aren't available): - From the **Test profile** dropdown, select a test profile in the context of whom the test request will be performed. - From the **Event context** dropdown list, you can select a particular occurrence of an event whose values/information will be used for the test request. 1. Select a test profile. **Result**: A history of test profile events appears.
A stream of events of a test profile
A stream of events of a test profile
2. From the list of events, select one whose data you want use as a context. If there is no event you can use, in the upper-right corner of the pop-up, click **Define own event** and provide the body of the event. 3. Confirm by clicking **Apply**. 3. Verify the request body. If there is something you want to change, come back to the node settings from previous steps. 3. If the request body is ready to test, in the upper-right corner, click **Send request**. **Result**: The response section appears and the **Update response event** button becomes active. 4. Optionally, you can update response event with new parameters by clicking **Update response event** in the upper-right corner. ## Example of use --- For an example of use refer to our [use case](/use-cases/sending-events-facebook).