> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFEventsWriteTelemetryEventsAsync

> Write batches of entity based events to as Telemetry events (bypass PlayStream). The namespace must be 'custom' or start with 'custom.'

Write batches of entity based events to as Telemetry events (bypass PlayStream). The namespace must be 'custom' or start with 'custom.'

## Syntax

```cpp theme={null}
HRESULT PFEventsWriteTelemetryEventsAsync(  
    PFEntityHandle entityHandle,  
    const PFEventsWriteEventsRequest* request,  
    XAsyncBlock* async  
)  
```

### Parameters

**`entityHandle`**   PFEntityHandle

PFEntityHandle to use for authentication.

**`request`**   [PFEventsWriteEventsRequest\*](/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsrequest)

Populated request object.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock for the async operation.

### Return value

Type: HRESULT

Result code for this API operation.

## Remarks

This API is available on all platforms. This API must be called with either X-EntityToken or X-TelemetryKey headers. If sending X-EntityToken the value must be a valid EntityToken for your title. If using X-TelemetryKey the value must be a Telemetry Key configured for your title set to 'Active'. If both are provided, X-TelemetryKey will be ignored. When the asynchronous task is complete, call [PFEventsWriteTelemetryEventsGetResultSize](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize) and [PFEventsWriteTelemetryEventsGetResult](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult) to get the result.

## Requirements

**Header:** PFEvents.h

## See also

[PFEvents members](/services/playfab/api-references/c/pfevents/pfevents_members)


## Related topics

- [PFEventsWriteTelemetryEventsGetResult](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md)
- [Services C API overview - PFEvents.h](/services/playfab/api-references/c/pfevents/pfevents_members.md)
- [PFEventsWriteTelemetryEventsGetResultSize](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize.md)
- [PFEventsWriteEventsAsync](/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsasync.md)
- [Telemetry](/services/playfab/data-analytics/ingest-data/telemetry-overview.md)