# mParticle

> mParticle is a customer data platform (CDP) that collects, unifies and activates customer data
> across mobile, web, OTT and server sources, then forwards it in real time to hundreds of
> analytics, marketing and warehouse destinations. Acquired by Rokt. This file is generated by
> API Evangelist from mParticle's own published artifacts — mParticle does not serve an llms.txt
> of its own (https://docs.mparticle.com/llms.txt returns HTTP 200 but the body is the Gatsby
> single-page-app HTML shell, not an llms.txt).

Authentication splits by API family. Ingestion APIs (Events, IDSync) use a workspace API
key/secret over HTTP Basic, and IDSync additionally offers an HMAC-SHA256 request digest
(`x-mp-key` / `Date` / `x-mp-signature`). Management APIs (Platform, Data Planning, Warehouse
Sync) use OAuth 2.0 client credentials against `https://sso.auth.mparticle.com/oauth/token` with
`audience=https://api.mparticle.com`, returning a bearer JWT that lives about 8 hours and cannot
be revoked.

There is no idempotency contract, no pagination, no RFC 9457 problem details, no deprecation
policy, no reachable status page, no MCP server and no A2A agent card. There IS a strong runtime
rate-limit signal: `X-mp-rate-limit-percentage-used` on 2xx responses and
`X-mp-rate-limit-exceeded` plus `Retry-After` on 429.

## Machine-readable specifications (published by mParticle)

- [Events API OpenAPI 3.0.3](https://docs.mparticle.com/downloads/mparticle.events.oas.yaml): POST /events and POST /bulkevents on https://s2s.mparticle.com/v2
- [Data Planning API OpenAPI 3.0.2](https://docs.mparticle.com/downloads/mparticle.dataplanning.oas.yaml): 10 operations on https://api.mparticle.com/platform/v2/workspaces/{workspace_id}/plans
- [IDSync (Identity) API Swagger 2.0](https://docs.mparticle.com/downloads/identity-swagger.yaml): /identify, /login, /logout, /{mpid}/modify on https://identity.mparticle.com/v1
- [Events API JSON Schema](https://docs.mparticle.com/schema/mparticle.inbound.eventsapi.schema.json): the event-batch contract
- [Events API bulk JSON Schema](https://docs.mparticle.com/schema/mparticle.inbound.eventsapi.bulk.schema.json)
- [Sample event batch](https://docs.mparticle.com/schema/mparticle.inbound.eventsapi.sample.json)
- [Data Planning Postman collection](https://docs.mparticle.com/downloads/dataplanning.postman_collection.json)
- [OIDC discovery for the OAuth issuer](https://sso.auth.mparticle.com/.well-known/openid-configuration)

## APIs

- [Events API](https://docs.mparticle.com/developers/apis/http/): server-to-server event ingestion; HTTP Basic; 128 KB per batch, 100 batches per bulk request
- [IDSync API](https://docs.mparticle.com/developers/apis/idsync/): identity resolution returning a stable mParticle ID (MPID)
- [Profile API](https://docs.mparticle.com/developers/apis/profile-api/): read unified user profiles, attributes and audience memberships
- [Platform API](https://docs.mparticle.com/developers/apis/platform/overview/): configure inputs, outputs, filters, audiences, users and workspaces
- [Data Planning API](https://docs.mparticle.com/developers/apis/dataplanning-api/): manage data plans and validate event batches against them
- [Warehouse Sync API](https://docs.mparticle.com/developers/apis/warehouse-sync-api/overview/): pipelines that pull data out of a customer data warehouse
- [Data Subject Request API](https://docs.mparticle.com/developers/apis/dsr-api/v3/): GDPR/CCPA access and erasure requests
- [Audit Logs API](https://docs.mparticle.com/developers/apis/audit-logs-api/)
- [Bulk Profile Deletion API](https://docs.mparticle.com/developers/apis/bulk-profile-deletion-api/)
- [Household Reach API](https://docs.mparticle.com/developers/apis/household-reach-api/)
- [Pixel Service](https://docs.mparticle.com/developers/apis/pixel-service/)

## Events and webhooks

- [Webhook output integration](https://docs.mparticle.com/integrations/webhook/event/): mParticle POSTs event batches to a customer URL. No AsyncAPI, no delivery signature; the only receiver auth is a static Authorization header value.

## Operations

- [Default service limits and rate limits](https://docs.mparticle.com/guides/default-service-limits/)
- [Web SDK changelog](https://docs.mparticle.com/developers/client-sdks/web/changelog/web-sdk-changelog/)
- [Apple SDK changelog](https://docs.mparticle.com/developers/client-sdks/ios/changelog/apple-sdk-changelog/)
- [Android SDK changelog](https://docs.mparticle.com/developers/client-sdks/android/changelog/android-sdk-changelog/)
- [Trust center](https://trust.mparticle.com/): SOC 2, ISO 27001, GDPR
- [Vulnerability disclosure (Rokt)](https://www.rokt.com/vulnerability-disclosure/)
- [security.txt](https://www.mparticle.com/.well-known/security.txt)

## SDKs and tooling

- [GitHub organization](https://github.com/mParticle)
- [Web SDK](https://www.npmjs.com/package/@mparticle/web-sdk) — 2.78.0 (2026-08-12)
- [Go SDK for the Events API](https://pkg.go.dev/github.com/mParticle/mparticle-go-sdk) — v1.1.7 (2026-08-06)
- [Java server events SDK](https://central.sonatype.com/artifact/com.mparticle/server-events-sdk) — 2.6.0 (2024-10-24)
- [Python SDK](https://pypi.org/project/mparticle/) — 0.16.1 (2023-06-20)
- [Ruby SDK](https://rubygems.org/gems/mparticle) — 1.1.1 (2021-08-02)
- [Node SDK](https://www.npmjs.com/package/mparticle) — 1.0.8 (2021-11-17)
- [.NET SDK](https://www.nuget.org/packages/mParticle.Sdk) — 1.4.0 (2022-06-28)
- [mParticle CLI](https://www.npmjs.com/package/@mparticle/cli) — 1.0.8 (2022-03-31), Data Planning commands only

## Commercial

- [Pricing](https://www.mparticle.com/pricing/): contact sales only — no tiers, prices or volumes are published
- [Platform terms of service](https://www.mparticle.com/legal/platform-terms-of-service/)
- [Privacy policy](https://www.mparticle.com/privacypolicy/)
- [Sign in](https://app.mparticle.com/login)

## API Evangelist profile

- [apis.yml](https://raw.githubusercontent.com/api-evangelist/mparticle/refs/heads/main/apis.yml)