# Subscribe to incoming contact events in Amazon Connect Agent Workspace
<a name="3P-apps-contact-requests-on-incoming"></a>

Creates a subscription whenever a new incoming event occurs in the Amazon Connect agent workspace.

 **Signature** 

```
onIncoming(handler: ContactIncomingHandler, contactId?: string): void                
```

 **Usage** 

```
const handler: ContactIncomingHandler = async (data: ContactIncoming) => {
    console.log("Contact incoming occurred! " + data);
};

contactClient.onIncoming(handler);

// ContactIncoming Structure
{
    contactId: string;
    initialContactId: string | undefined;
    type: ContactChannelType["type"];
    subtype: ContactChannelType["subtype"];
}
```

 **Permissions required:** 

```
*
```