AppsFlyer

AppsFlyer Measure in-app events API

The Measure in-app events API from AppsFlyer — 1 operation(s) for measure in-app events.

GitHub OpenAPI

Operations 1

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /inapp/app/{platform}/{app-id} Measure an in-app event on a CTV app · Measure in-app events #
Ask an LLM
“Can a post-install event in my TV app be attributed to a campaign?”
“Can I attach custom event parameters to a CTV in-app event?”
Tell an agent
Record event {event} for {app} on {platform} from IP {ip} with device IDs {device_ids}.
Measure CTV event {event} on {app} ({platform}) with parameters {params} from IP {ip} and device IDs {device_ids}.

Documentation

📖
Documentation
https://dev.appsflyer.com/hc/reference/api-reference-overview
📖
APIReference
https://dev.appsflyer.com/hc/reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/appsflyer/refs/heads/main/authentication/appsflyer-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/appsflyer/refs/heads/main/openapi/appsflyer-measure-in-app-events-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/appsflyer/refs/heads/main/conventions/appsflyer-conventions.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/appsflyer/refs/heads/main/sandbox/appsflyer-sandbox.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/appsflyer/refs/heads/main/asyncapi/appsflyer-push-api-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/appsflyer:appsflyer-measure-in-app-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

appsflyer-measure-in-app-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: PC/Console/CTV Events Measure in-app events API
  version: 1.0.0
servers:
- url: https://events.appsflyer.com/v1.0/s2s/
  description: Production server
- url: https://sandbox-events.appsflyer.com/v1.0/s2s/
  description: Sandbox server
security:
- ApiKeyAuth: []
tags:
- name: Measure in-app events
paths:
  /inapp/app/{platform}/{app-id}:
    post:
      tags:
      - Measure in-app events
      summary: Measure in-app events
      description: '> ℹ️ This is a server to server API. If you need to report events directly from your application''s client please see this section or contact your CSM


        This AppsFlyer API integration allows advertisers to measure any

        post-install in-app event and attribute it to a media source and campaign'
      parameters:
      - $ref: '#/components/parameters/AppId'
      - $ref: '#/components/parameters/Platform'
      requestBody:
        content:
          application/json:
            schema:
              required:
              - device_ids
              - event_name
              - ip
              type: object
              properties:
                timestamp:
                  type: integer
                  description: Event timestamp in Unix time milliseconds (UTC). If the provided timestamp is in the future or older than 96 hours, the current timestamp will be used instead.
                  format: int64
                  example: 1625576172928
                request_id:
                  maxLength: 36
                  minLength: 36
                  type: string
                  description: Unique identifier per request
                  example: 71dad7da-7926-40d8-9b15-b94a6d46e15a
                ip:
                  maxLength: 46
                  minLength: 1
                  type: string
                  description: The device IP address - IPv4 only.
                  example: 35.244.183.10
                user_agent:
                  maxLength: 256
                  minLength: 1
                  type: string
                  description: The device user agent
                  example: Roku/DVP-9.21 (AE9.21E04090A)
                device_os_version:
                  maxLength: 12
                  minLength: 1
                  type: string
                  pattern: ^[0-9.\-]+$
                  description: The device OS version
                  example: 9.3.0
                device_model:
                  maxLength: 50
                  minLength: 1
                  type: string
                  pattern: ^[A-Za-z0-9.\(\)\- ]+$
                  description: The device model
                  example: 3920X
                device_ids:
                  $ref: '#/components/schemas/DeviceIds'
                limit_ad_tracking:
                  type: boolean
                  description: Limit Ad Tracking flag. Use this flag to mark whether or not the user has advertiser ID
                  example: true
                customer_user_id:
                  maxLength: 64
                  minLength: 1
                  type: string
                  description: Customer user ID, as set by the developer. This is used as the user identifier in the advertiser's system
                  example: 15667737-366d-4994-ac8b-653fe6b2be4a
                app_version:
                  maxLength: 24
                  minLength: 1
                  type: string
                  pattern: ^[A-Za-z0-9.\-]+$
                  description: The release or version number of the app
                  example: 1.0.5
                event_name:
                  maxLength: 64
                  minLength: 1
                  type: string
                  description: A string describing the event name
                  example: af_purchase
                event_parameters:
                  type: object
                  properties:
                    af_revenue:
                      type: number
                      format: double
                    af_currency:
                      type: string
                      enum:
                      - USD
                      - AED
                      - AFN
                      - ALL
                      - AMD
                      - ANG
                      - AOA
                      - ARS
                      - AUD
                      - AWG
                      - AZN
                      - BAM
                      - BBD
                      - BDT
                      - BGN
                      - BHD
                      - BIF
                      - BMD
                      - BND
                      - BOB
                      - BRL
                      - BSD
                      - BTC
                      - BTN
                      - BWP
                      - BYN
                      - BZD
                      - CAD
                      - CDF
                      - CHF
                      - CLF
                      - CLP
                      - CNH
                      - CNY
                      - COP
                      - CRC
                      - CUC
                      - CUP
                      - CVE
                      - CZK
                      - DJF
                      - DKK
                      - DOP
                      - DZD
                      - EGP
                      - ERN
                      - ETB
                      - EUR
                      - FJD
                      - FKP
                      - GBP
                      - GEL
                      - GGP
                      - GHS
                      - GIP
                      - GMD
                      - GNF
                      - GTQ
                      - GYD
                      - HKD
                      - HNL
                      - HRK
                      - HTG
                      - HUF
                      - IDR
                      - ILS
                      - IMP
                      - INR
                      - IQD
                      - IRR
                      - ISK
                      - JEP
                      - JMD
                      - JOD
                      - JPY
                      - KES
                      - KGS
                      - KHR
                      - KMF
                      - KPW
                      - KRW
                      - KWD
                      - KYD
                      - KZT
                      - LAK
                      - LBP
                      - LKR
                      - LRD
                      - LSL
                      - LYD
                      - MAD
                      - MDL
                      - MGA
                      - MKD
                      - MMK
                      - MNT
                      - MOP
                      - MRO
                      - MRU
                      - MUR
                      - MVR
                      - MWK
                      - MXN
                      - MYR
                      - MZN
                      - NAD
                      - NGN
                      - NIO
                      - NOK
                      - NPR
                      - NZD
                      - OMR
                      - PAB
                      - PEN
                      - PGK
                      - PHP
                      - PKR
                      - PLN
                      - PYG
                      - QAR
                      - RON
                      - RSD
                      - RUB
                      - RWF
                      - SAR
                      - SBD
                      - SCR
                      - SDG
                      - SEK
                      - SGD
                      - SHP
                      - SLL
                      - SOS
                      - SRD
                      - SSP
                      - STD
                      - STN
                      - SVC
                      - SYP
                      - SZL
                      - THB
                      - TJS
                      - TMT
                      - TND
                      - TOP
                      - TRY
                      - TTD
                      - TWD
                      - TZS
                      - UAH
                      - UGX
                      - UYU
                      - UZS
                      - VEF
                      - VES
                      - VND
                      - VUV
                      - WST
                      - XAF
                      - XAG
                      - XAU
                      - XCD
                      - XDR
                      - XOF
                      - XPD
                      - XPF
                      - XPT
                      - YER
                      - ZAR
                      - ZMW
                      - ZWL
                      - BYR
                  example:
                    af_revenue: 1.99
                    af_currency: MYR
                event_custom_parameters:
                  description: A JSON object which can contain multiple parameters. Learn more [here](https://support.appsflyer.com/hc/en-us/articles/4410481112081-Rich-in-app-events-Event-structure)
                  type: string
                  format: json
                  maxLength: 2048
                  example: '{"test_param": "test_data", "af_price":6.66, "player_level": 55, "af_duration_seconds": 100}'
                sharing_filter:
                  $ref: '#/components/schemas/SharingFilter'
        required: true
      responses:
        '202':
          description: The request was accepted
          content: {}
        '400':
          description: Mandatory fields in the message body are missing, or fields are invalid
          content: {}
        '401':
          description: The app doesn't exist or the authentication failed
          content: {}
        '403':
          description: App traffic blocked due to Zero package limit
          content: {}
        '500':
          description: Internal server error
          content: {}
      x-codegen-request-body-name: body
      operationId: postInappAppByPlatformByAppId
      x-operation-id-source: derived
components:
  parameters:
    Platform:
      name: platform
      in: path
      schema:
        type: string
        enum:
        - ''
        - roku
        - smartcast
        - tizen
        - webos
        - playstation
        - vidaa
        - steam
        - quest
        - battlenet
        - epic
        - switch
        - xbox
        - nativepc
        - vega
      required: true
      description: 'The CTV platform of the measured app

        '
    AppId:
      name: app-id
      in: path
      schema:
        type: string
        pattern: ^[A-Za-z0-9.\-]+$
      required: true
      description: 'Application ID

        '
  schemas:
    SharingFilter:
      description: "The sharing filter blocks the sharing of events via postbacks/API with integrated partners and other third-party integrations.\nUse the filter to fulfill regulatory requirements like GDPR and CCPA, to comply with user opt-out mechanisms, and for other business logic reasons. \n\nThe `sharing_filter` has the following options:\n\n- `all`: All partners are blocked. Don't share the event with anyone. Example: \"sharing_filter\": \"all\"\n- List of partner ids in an array. \n\n**Note:** \n  To find out the required partner IDs:\n  1. Run the [Get active integrations API](https://dev.appsflyer.com/hc/reference/get_v1-integrations) for a list of all active integrations\n  2. Use the `media_source_name` values from the [API response](https://dev.appsflyer.com/hc/reference/get_v1-integrations) as input values to the method `partners` array. \n"
      type: array
      items:
        type: string
        minLength: 1
      minItems: 1
      oneOf:
      - type: array
        items:
          type: string
          minLength: 1
        minItems: 1
        title: list partners blocked
      - type: array
        items:
          type: string
          enum:
          - all
        minItems: 1
        maxItems: 1
        title: all partners blocked
    DeviceIds:
      type: array
      description: A vector of the different device IDs. Can be either advertising ID or a custom ID. The custom device ID is mapped to `appsflyer_id`in raw data reports.
      example:
      - type: rida
        value: fa73d67d-f55c-5af3-883a-726253dc7d0e
      - type: custom
        value: 045f4137-57b7-45e6-8a45-c303101a086a
      items:
        required:
        - type
        - value
        type: object
        properties:
          type:
            type: string
            enum:
            - custom
            - rida
            - vida
            - tifa
            - lgudid
            - vidaaid
            - steamid
            - epicid
            - psid
            - vegaid
            description: '`custom` format is GUID

              '
          value:
            type: string
            pattern: ^[A-Za-z0-9\-_]+$
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: 'Create an HMAC signature by hashing the entire raw message.

        The HMAC is generated using SHA256 and uses the DevKey as the signature’s secret key.


        For example, the raw message is: `{"timestamp":1604503583337,"ip":"127.0.0.1","user_agent":"Roku/DVP-9.21 (AE9.21E04090A)","device_os_version":"9.3.0","device_model":"3920X","device_ids":[{"type":"rida","value":"fa73d67d-f55c-5af3-883a-726253dc7d0e"}],"limit_ad_tracking":false}`


        The DevKey is: `w8sZzy8EaPaxFKfaoTqUi6`

        The result is: `715b133d5a327b77beb898688a3ad438da0f78071cd3df70e8ec5ecf60751972`

        '
      name: authorization
      in: header