Amazon Mobile Analytics

Name: Amazon Mobile Analytics API
Brand: Amazon Mobile Analytics
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAnalyticsProduct Analyticshmac1 EndpointsREST

For Agents

Submit batched mobile event records (sessions, screen views, custom events) for a registered application to the legacy Amazon Mobile Analytics ingest endpoint.

Quickstart

Get started with Amazon Mobile Analytics in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"submit mobile analytics events"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Amazon Mobile Analytics API.

Submit a batch of mobile app events (session start, session stop, custom events) in a single PutEvents call

Attach per-batch client context (appId, appVersion, locale, platform) via the x-amz-Client-Context header

Stamp every event with a session id, start and stop timestamps, and arbitrary string and metric attributes

Stream high-volume mobile telemetry from devices with a single fire-and-forget POST per batch

GET STARTED

Start building with Amazon Mobile Analytics API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Amazon Mobile Analytics, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Amazon Mobile Analytics, keeping it validated and agent-ready. Amazon Mobile Analytics is a lightweight event-collection endpoint for mobile applications — apps batch user events on the device and POST them to a single PutEvents endpoint with a per-call x-amz-Client-Context header that identifies the app, version and device. AWS has since folded this surface into Amazon Pinpoint, but the legacy ingest endpoint remains callable for apps that have not yet migrated.

Use Cases

Patterns agents use Amazon Mobile Analytics API for, with concrete tasks.

★ Ingest Batched Mobile App Events

Mobile clients buffer events on-device and need a single low-latency endpoint to flush them to AWS. PutEvents accepts an array of event objects with timestamps, attributes and metrics, plus a base64-encoded x-amz-Client-Context header that identifies the app version and platform. The endpoint is fire-and-forget and is designed for high-volume, lossy mobile traffic — useful for legacy apps still pointing at the Mobile Analytics ingest URL.

Build a PutEvents payload with eventType=_session.start, timestamp=now, and a base64-encoded x-amz-Client-Context header, then POST it to /2014-06-05/events

Migrate Legacy Apps Off Mobile Analytics

AWS has folded Mobile Analytics into Amazon Pinpoint. Teams running older app versions still call the legacy endpoint, and need a way to detect, capture and re-route those events. An agent can wrap the existing PutEvents endpoint, log incoming batches for audit, and replay the same event shape into Pinpoint Events to support a phased migration without forcing an immediate client update.

Read a PutEvents batch from a queue, transform each event to the Pinpoint Events shape, and call the Pinpoint PutEvents operation with the same eventType and attributes

Validate Mobile Telemetry SigV4 Signatures

Because PutEvents is the only call in the surface, it is a good test bed for verifying SigV4 signing flows for mobile clients before rolling them out to busier services. An agent can construct a signed request, send a small synthetic batch, and use the success/failure response to confirm IAM permissions and clock-skew handling for a target region.

Sign a synthetic PutEvents batch with SigV4 for region us-east-1, send it, and assert the response is 202 Accepted

AI Agent Integration for Legacy Mobile Telemetry

Through Jentic, an agent can call Mobile Analytics' PutEvents endpoint without manually constructing the x-amz-Client-Context header or handling SigV4 signing. Jentic resolves the intent 'submit mobile analytics events', loads the schema for the single PutEvents operation and brokers AWS credentials, so legacy mobile telemetry can be replayed or tested by an LLM agent in a single tool call.

Resolve the intent 'submit mobile analytics events' via Jentic search, load the PutEvents schema, and execute it with an event batch and a base64-encoded client context

Key Endpoints

1 endpoints — jentic publishes the only available openapi specification for amazon mobile analytics, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/2014-06-05/events#x-amz-Client-Context

Submit a batch of mobile app events with client context

POST

/2014-06-05/events#x-amz-Client-Context

Submit a batch of mobile app events with client context

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

AWS access keys live in the Jentic MAXsystem vault. Jentic SigV4-signs each PutEvents request on the agent's behalf — the agent only ever sees a session, never the raw access key or secret.

Intent-based discovery

Agents search by intent (e.g., 'submit mobile analytics events') and Jentic returns the single PutEvents operation with its input schema and required header layout, so the agent can submit a batch without consulting the AWS docs.

Time to first call

Direct Mobile Analytics integration: half a day for SigV4 signing and the x-amz-Client-Context base64 encoding. Through Jentic: under 30 minutes — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Amazon Pinpoint Email

Pinpoint is the successor that absorbs Mobile Analytics event ingest into a richer engagement platform

Choose Pinpoint for new mobile analytics work — Mobile Analytics should only be used for legacy apps still wired to the 2014 endpoint.

Complementary

Amazon EventBridge

EventBridge can fan out post-processed mobile events to downstream consumers and analytics pipelines

Use after ingest when an agent needs to route mobile events into multiple AWS services (Lambda, SQS, Firehose) for further processing.

Complementary

Amazon Cognito Identity

Cognito provides federated identity tokens that mobile clients exchange for the temporary credentials used to call PutEvents

Use to mint scoped, short-lived AWS credentials for mobile clients before they sign Mobile Analytics calls.

FAQs

Specific to using Amazon Mobile Analytics API through Jentic.

Why is there no official OpenAPI spec for Amazon Mobile Analytics?

AWS does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Amazon Mobile Analytics via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Amazon Mobile Analytics API use?

The PutEvents endpoint is signed with AWS Signature Version 4 using an access key ID and secret access key scoped by IAM. Through Jentic, those AWS credentials sit in the MAXsystem vault and are used to sign requests on the agent's behalf — the raw access key never enters the agent's context.

Can I submit multiple events in a single Mobile Analytics call?

Yes. PutEvents accepts a JSON array of event objects in a single request, each with its own eventType, timestamp, session block, and attributes/metrics maps. Mobile SDKs typically buffer events and flush them in batches of tens or hundreds per call.

What is the x-amz-Client-Context header for?

Mobile Analytics requires a base64-encoded JSON header named x-amz-Client-Context describing the app (appId, appTitle, appVersionName, appVersionCode), client (clientId), and environment (platform, locale, model). Without it, PutEvents rejects the batch — the events themselves do not carry the app identity.

How do I send events to Mobile Analytics through Jentic?

Use the Jentic search query 'submit mobile analytics events', load the PutEvents operation schema, and execute it with your event array and a base64-encoded x-amz-Client-Context. Jentic signs the request with SigV4 against your stored AWS credentials so the agent does not need to handle signing directly.

Should new apps be using Mobile Analytics or Pinpoint?

AWS positions Amazon Pinpoint as the successor for mobile event analytics. Treat Mobile Analytics as a legacy ingest path for apps already shipping with the older endpoint, and use the Pinpoint APIs in the Jentic catalogue for new instrumentation.