> ## 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.

# PFEventsWriteEventsAsync

> Write batches of entity based events to PlayStream. The namespace of the Event must be 'custom' or start with 'custom.'.

Write batches of entity based events to PlayStream. The namespace of the Event must be 'custom' or start with 'custom.'.

## Syntax

```cpp theme={null}
HRESULT PFEventsWriteEventsAsync(  
    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. When the asynchronous task is complete, call [PFEventsWriteEventsGetResultSize](/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsgetresultsize) and [PFEventsWriteEventsGetResult](/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsgetresult) to get the result.

## Requirements

**Header:** PFEvents.h

## See also

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


## Related topics

- [PFEventsWriteEventsGetResult](/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsgetresult.md)
- [Services C API overview - PFEvents.h](/services/playfab/api-references/c/pfevents/pfevents_members.md)
- [PFEventsWriteTelemetryEventsAsync](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsasync.md)
- [PFEventsWriteTelemetryEventsGetResult](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md)
- [PFEventsWriteEventsGetResultSize](/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsgetresultsize.md)