> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# receive

> Subscribe to additional contexts for inbound events.

[relayclient-constructor]: /docs/server-sdks/reference/typescript/relay/client

Subscribe to additional contexts for inbound call and message events. Sends a
`signalwire.receive` request to start receiving events on the specified contexts
without reconnecting.

Use this to dynamically expand the set of contexts after the initial connection.
Contexts passed to the [`RelayClient` constructor][relayclient-constructor]
are subscribed automatically at connect time -- this method is for adding more
at runtime.

> **Tip**
>
> Contexts are strings that act as routing labels. A phone number configured in
> your SignalWire dashboard sends calls to a specific context. Subscribe to that
> context to receive those calls.

## **Parameters**

**`contexts`** `string[]` — required

List of context names to subscribe to. If the list is empty, the method
returns immediately without sending a request.

---

## **Returns**

`Promise<void>`

## **Examples**

### Add contexts at runtime

```typescript {12}
import { RelayClient } from '@signalwire/sdk';

const client = new RelayClient({
  project: process.env.SIGNALWIRE_PROJECT_ID!,
  token: process.env.SIGNALWIRE_API_TOKEN!,
  contexts: ['sales']
});

await client.connect();

// Dynamically subscribe to additional contexts after connecting
await client.receive(['support', 'billing']);
console.log('Now receiving calls on sales, support, and billing');

await client.disconnect();
```

### With inbound call handler

```typescript {16}
import { RelayClient } from '@signalwire/sdk';

const client = new RelayClient({
  project: process.env.SIGNALWIRE_PROJECT_ID!,
  token: process.env.SIGNALWIRE_API_TOKEN!,
  contexts: ['sales']
});

client.onCall(async (call) => {
  console.log(`Call on context: ${call.context}`);
  await call.answer();
  await call.hangup();
});

await client.connect();
await client.receive(['support', 'billing']);
console.log('Now also receiving on support and billing');
```

> Subscribe to additional contexts for inbound events.