## Ingest

`client.v1.usage.ingest(UsageIngestParamsbody?, RequestOptionsoptions?): void`

**post** `/v1/ingest`

Send usage events to Metronome. The body of this request is expected to be a JSON array of between 1 and 100 usage events. Compressed request bodies are supported with a `Content-Encoding: gzip` header. See [Getting usage into Metronome](https://docs.metronome.com/connect-metronome/) to learn more about usage events.

### Parameters

- **body:** `UsageIngestParams`

  - **usage:** `Array<Usage>`

    - **customer\_id:** `string`

    - **event\_type:** `string`

    - **timestamp:** `string`

      RFC 3339 formatted

    - **transaction\_id:** `string`

    - **properties:** `Record<string, unknown>`

### Example

```node
import Metronome from '@metronome/sdk';

const client = new Metronome({
  bearerToken: 'My Bearer Token',
});

await client.v1.usage.ingest([
  {
    customer_id: 'team@example.com',
    event_type: 'heartbeat',
    timestamp: '2021-01-01T00:00:00Z',
    transaction_id: '2021-01-01T00:00:00Z_cluster42',
  },
]);
```