Create an Ingestion API Data Stream

Create an Ingestion API data stream from your source objects. After the data stream is created, your developer can stream in data from your external sources.

Make sure that your admin has set up the Ingestion API connector and that the schema file is uploaded.

1. In Data Cloud, select Data Streams, or in the App Launcher, find, and select Data Streams.

2. In recently viewed data streams, click New.

3. Click Ingestion API.

4. If you have more than one Ingestion API configured, select the one that you want in the dropdown.

5. Select the schema objects that you want to use, and click Next.

6. In the New Data Stream dialog box, configure these items.

   1. For Primary Key, select the field to use to uniquely identify a record. For more information, see primary key.

   2. Select the object’s category. For more information, see category.

   3. For Record Modified Field, select the field that indicates when the incoming record was last modified.

      This field is available only for Profile and Other category objects. Although it’s an optional field, providing this information helps ensure that incoming records are processed in the correct order.

   4. If you selected the Engagement category, enter the Event Time Field. Choose a field that defines when the engagement from an external source occurred at ingestion and is unchanging over time.

7. Click Next.

8. On the summary screen, review the data streams that Data Cloud created.

9. From the Data Space dropdown, select the applicable data space or the default data space.

10. Click Deploy.

    If you created only one data stream, its record page appears. If you created multiple data streams, the view refreshes to show all recently viewed data streams.

After the data streams are deployed, you can make calls to the object endpoints to send data into Data Cloud.

Wait up to 1 hour for your data to appear in your data stream. Map your data stream to data model objects (DMO) to start using your data. To confirm that data has been ingested, check your DMOs on the Data Explorer tab. To use the data in segmentation and activation, a data aware specialist can navigate to each data stream and complete mapping the standard Salesforce or custom objects.