---
title: "Number Masking callback API"
method: POST
path: "receive-number-masking-target"
tags: ["channels", "voice", "number-masking", "number-masking-events"]
---

# Number Masking callback API

`POST receive-number-masking-target` (webhook)

Upon receiving a call to the Number Masking number, the Infobip platform generates a request to the **callbackUrl** you set up 
in the Number Masking configuration. This request will contain the callee number and the Voice number that's called. We also provide 
**correlationID** and **nmCorrelationID** to be used as identifiers for this call request.

In return from your platform, the Infobip platform expects to receive the phone number needed to forward the call to and the caller ID 
that should be presented. Caller ID representation depends on the voice connection capabilities in a particular region. Instead of the number, 
you could also send a parameter **audio** so we would play an audio file that was previously uploaded to our platform 
[(Audio file upload)](#customer-engagement/anonymize/upload-audio-files) or hosted on your server. Also, you can send a 
parameter **captureDtmf** to play an audio file and start capturing DTMF input that will be sent as the `from` field in the new callback request.

## Headers

- `Authorization` string

## Payload

- 322179e48f777ec7fa4be8d16ebc634ba865098b0ae9d513535e196958077f6cWebhookCallbackRequest: Callback request.
  - `from` string: Caller phone number.
  - `to` string: Called phone number.
  - `correlationId` string: Unique identifier of the call record, available for both Callback and Status requests.
  - `nmCorrelationId` string: Unique identifier for correlation with inbound call, available in Callback and Status requests.
  - `dtmfCaptured` boolean: Indicates that this callback request is initiated after the `captureDtmf` command is executed. Not present in the first callback request for the call.

## Acknowledgement `200`

OK

- 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8CallbackResponse
  - `command` string, required

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)