For Agents
Submit batched mobile event records (sessions, screen views, custom events) for a registered application to the legacy Amazon Mobile Analytics ingest endpoint.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Amazon Mobile Analytics, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
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
GET STARTED
Use for: Submit a batch of session-start events for a mobile app, Send custom event records to Mobile Analytics for app appId-xyz, Post a screen-view event with custom string and metric attributes, Forward queued mobile telemetry to AWS Mobile Analytics
Not supported: Does not handle event querying, dashboards, segmentation, or message campaigns — use for fire-and-forget ingest of mobile event batches only.
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.
Stream high-volume mobile telemetry from devices with a single fire-and-forget POST per batch
Sign batched event ingest with AWS SigV4 so device-side credentials remain scoped to the analytics action only
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
1 endpoints — jentic publishes the only available openapi specification for amazon mobile analytics, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/2014-06-05/events#x-amz-Client-Context
Submit a batch of mobile app events with client context
/2014-06-05/events#x-amz-Client-Context
Submit a batch of mobile app events with client context
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.
Alternatives and complements available in the Jentic catalogue.
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.