Inbound Integrations

Partners can send client data to mParticle as a Feed, so that mutual customers can forward their data on to other services. To make a customer’s data available as a Feed, you need to send it to mParticle’s Events API using our dedicated partner URLs:

Endpoint Partner URLs
events https://inbound.mparticle.com/s2s/v2/events
bulkevent https://inbound.mparticle.com/s2s/v2/bulkevents
bulkevents/historical http://inbound.mparticle.com/s2s/v2/bulkevents/historical

mParticle will provide you with a template to complete with information about your company and the data your feed will provide. We will also work with you to document your feed and test that it performs as expected.

To build a Feed integration, you need to:

  1. Create a function or service to convert the data you want to forward into mParticle’s batch format.
  2. Create a secure way for your clients to be able to provide you with the API Key and Secret necessary to send their data to mParticle’s Events API. You can either build this into your Platform UI or communicate directly with each client wanting to access your Feed in mParticle.
  3. Using the credentials provided by each client, forward data to our HTTPS API endpoint. See our Events API documentation for more information.
  4. Ensure that your function or service will respond to an HTTP 429 Too Many Request response so that no data is dropped. Learn more about API throttling in Default Service Limits.

Don’t forget to provide a high-resolution logo to mParticle in SVG format with a transparent background.

Was this page helpful?