---
title: "Capture a signed marketing attribution identity mapping"
method: POST
path: "/identify"
tags: ["Marketing"]
---

# Capture a signed marketing attribution identity mapping

`POST /identify`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/identify`
- Auth: none required

Compatibility alias for /marketing/identify used by the marketing snippet spec.

## Headers

- `x-median-signature` string

## Request body

- object
  - `companyId` string, uuid, required
  - `externalUserId` string, required
  - `provider` string
  - `stripeCustomerId` string, nullable
  - `gclid` string, nullable
  - `source` string, nullable
  - `medium` string, nullable
  - `campaign` string, nullable
  - `content` string, nullable
  - `term` string, nullable
  - `metadata` object

## Response `200`

Identity mapping captured

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)