# Create or update event subscription for multiple companies.

Endpoint: PUT /api/v3/subscriptions/{subscriptionName}
Version: v3
Security: client_credentials, implicit, client_credentials_dev, implicit_dev

## Path parameters:

  - `subscriptionName` (string, required)
    Subscription name (only A-Z a-z 0-9 and "-") (3-64 characters).

## Query parameters:

  - `skip` (integer)
    Number of entries to skip.

  - `take` (integer)
    Number of entries to return.

## Request fields (application/json-patch+json):

  - `companyIds` (array,null)

  - `eventTypes` (array,null)

  - `destination` (object)

  - `destination.endpointUrl` (string,null)

  - `destination.maxEventsPerBatch` (integer)

  - `destination.preferredBatchSizeInKilobytes` (integer)

  - `destination.azureActiveDirectoryApplicationIdOrUri` (string,null)

  - `destination.azureActiveDirectoryTenantId` (string,null)

## Response 200 fields (text/plain):

  - `totalCount` (integer)

  - `skip` (integer,null)

  - `take` (integer,null)

  - `items` (array,null)

  - `items.subscriptionName` (string,null)

  - `items.companyId` (string,null)

  - `items.provisioningState` (string,null)

  - `items.id` (string,null)

  - `items.topic` (string,null)

  - `items.labels` (array,null)

  - `items.links` (array,null)

  - `items.links.rel` (string,null)

  - `items.links.method` (string,null)

  - `items.links.href` (string,null)


## Response 400 fields

## Response 401 fields

## Response 404 fields