--- title: CleverTap API Integration on Truto slug: clevertap category: Marketing Automation canonical: "https://truto.one/integrations/detail/clevertap/" --- # CleverTap API Integration on Truto **Category:** Marketing Automation **Status:** Generally available ## Unified APIs ### Unified Marketing Automation API - **Campaigns** — The campaign represent a campaign in the remote system. ## How it works 1. **Link your customer's CleverTap account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach CleverTap.** The Proxy API is a 1-to-1 mapping of the CleverTap API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync campaign performance metrics into your analytics dashboard** — If you're building a marketing analytics or attribution platform, you can pull campaign delivery, open, click, and conversion data from your customers' CleverTap accounts to display alongside metrics from other channels — giving marketers a single pane of glass for all their engagement data. - **Enrich CleverTap user profiles from your SaaS platform** — If your product generates customer data — loyalty tiers, subscription status, support scores — you can push those attributes into your customers' CleverTap profiles so their marketers can build richer segments and trigger more personalized campaigns without manual CSV imports. - **Inject behavioral events to power CleverTap Journeys** — If your platform captures meaningful user actions (e.g., survey completions, payment failures, feature adoption milestones), you can push those events into CleverTap so your customers' marketing teams can use them as triggers for automated omnichannel campaigns. - **Trigger transactional campaigns from external workflows** — If your SaaS handles time-sensitive workflows like billing dunning, order confirmations, or security alerts, you can programmatically trigger pre-configured CleverTap campaigns so your customers can reach users via push, SMS, or email without building their own messaging infrastructure. ## What you can build - **Unified campaign performance dashboard** — Fetch campaign lists and time-series metrics (sends, opens, clicks, conversions) from CleverTap via the Unified Marketing Automation API and render them alongside data from other marketing channels in a single report. - **Real-time profile sync from your product to CleverTap** — Automatically update CleverTap user profiles with attributes like subscription tier, LTV, or loyalty points whenever those values change in your system. - **Server-side event forwarding for journey triggers** — Push custom events with rich properties (e.g., NPS score, purchase amount, feature flag changes) into CleverTap so marketers can use them as triggers in Journeys and segmentation rules. - **Automated dunning and transactional message triggers** — Call CleverTap's Target API from your billing or transactional workflow to fire a specific campaign to a user the moment a payment fails or an order ships. - **Segment-based audience export for ad targeting** — Pull user lists from CleverTap segments and sync them to advertising platforms like Meta or Google Ads so your customers can retarget high-value cohorts without manual exports. - **Cross-channel ROI comparison view** — Combine CleverTap push notification and in-app message performance data with paid media and email metrics to give marketers a true cross-channel cost-per-conversion analysis. ## FAQs ### How does authentication work for CleverTap integrations? CleverTap uses a Project ID and Passcode (API key) pair for server-to-server authentication, passed as headers on every request. Truto handles storing and injecting these credentials so your end users just enter their CleverTap project details once during the connection flow. ### What Unified APIs does Truto support for CleverTap? CleverTap is mapped to Truto's Unified Marketing Automation API for Campaigns. This lets you read campaign lists and performance metrics through a standardized schema. Additional tools and unified models can be built on request based on your specific use case. ### Are there rate limits I should be aware of? Yes. CleverTap enforces rate limits that vary by API endpoint and pricing tier. For example, the Upload API allows a limited number of requests per second per account. Truto manages retries and backoff logic so your integration handles throttling gracefully without you writing custom retry code. ### Can I push custom events and profile properties, or only read data? CleverTap's API supports both reads and writes. You can upload custom events and update user profile attributes via the Upload API, trigger campaigns via the Target API, and read campaign metrics via the Reports API. Specific Truto tools for write operations can be built on request. ### How fresh is the campaign metrics data from CleverTap? CleverTap's campaign report endpoints return near-real-time aggregate data. Metrics like sent, viewed, and clicked counts are typically available within minutes of delivery. Exact freshness depends on CleverTap's internal processing and the specific report endpoint used. ### Does CleverTap support region-specific API endpoints? Yes. CleverTap hosts data in multiple regions (US, EU, India, Singapore, and others), each with a distinct API base URL. Your end users need to specify their data region during the connection setup so API calls are routed to the correct cluster. Truto handles this routing automatically once configured.