Data 360: Best Practices for Sending Payloads Using Ingestion API in Data 360 (Formerly Data Cloud)

Steps to follow:

Follow these steps to correctly format and send your payload using the Ingestion API.

1. Go to Data 360 Setup:

  - Navigate to the Data 360 Setup in your Salesforce environment.

2. Search for Ingestion API:

  - Use the search bar to find "Ingestion API."

3. Select Your Connector Name:

  - From the list, select the name of your connector.

4. Locate the Integration Guide:

  - Scroll to the bottom of the page where you will find the "Integration Guide."

5. Download Schema:

  - Click on "Download Schema" to retrieve the full list of objects and field names expected by the Ingestion API.

6. Use the Downloaded Schema:

  - Use the names as shown in the schema to send the payload.

Example from downloaded file:

components:

  schemas:

    personName:

      type: object

      properties:

        identificationID:

          type: number

        createdDate:

          type: string

          format: date-time

Note:

If the payload is sent using field API names instead of the schema-defined field names, the system won't recognize the fields or their values. As a result, you'll observe a single row in the data stream with all columns blank. Since the payload lacks valid fields, the ingestion process treats each call as an upsert to the same record, ultimately leading to one record populated with only blank values.