> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Amplitude Event Settings

> Choose which Amplitude events sync without the webhook secret

Change which streamed events a connected Amplitude integration records.

This does **not** need the webhook secret. Sequenzy shows the secret once when you connect and never returns it, and reconnecting replaces it, which stops deliveries until you update the header in Amplitude. Use this endpoint to change events instead.

* `syncAllEvents: false` with an `eventAllowlist` records only those event types.
* `skipInternalEvents` drops `session_start`, `session_end`, `[Amplitude]` autocapture and other `$` events unless you allowlist them. New connections have it on.
* Identify calls always come through, so profile updates keep working.

Changes apply to deliveries processed after you save. Events dropped before that are not replayed. Cohort syncs are not affected.

Provide at least one field. Amplitude only: Mixpanel syncs cohorts only, and other providers return a `400`.

Requires an API key with the `integrations:manage` scope. Without it, change the same settings in the dashboard at Settings → Integrations → Amplitude.

## Request

**id** `string` *required*

Amplitude integration ID, from [List
Integrations](https://docs.sequenzy.com/api-reference/integrations/list.md).

**syncAllEvents** `boolean`

`true` records every event type. `false` records only `eventAllowlist`.

**eventAllowlist** `string[]`

Amplitude event types to record when `syncAllEvents` is `false`, exactly as
Amplitude names them. Replaces the saved list. Up to 500 names of at most 255
characters; names are trimmed and deduplicated. An empty list with
`syncAllEvents: false` returns `400`.

**skipInternalEvents** `boolean`

Skip session, `[Amplitude]` autocapture and other `$` events unless
allowlisted.

```bash theme={null}
curl -X PATCH "https://api.sequenzy.com/api/v1/integrations/int_abc123/amplitude" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "syncAllEvents": false,
    "eventAllowlist": ["Song Played", "Plan Upgraded"]
  }'
```

## Response fields

**success** `boolean`

`true` when the settings were saved.

**integration** `object`

The updated integration, with the same fields as [List
Integrations](https://docs.sequenzy.com/api-reference/integrations/list.md), including `eventSettings`
and `cohorts`.

**eventSettings** `object`

The saved scope: `{ syncAllEvents, eventAllowlist, skipInternalEvents }`.

## Errors

| Status | When |
| - | - |
| `400` | No field was provided, the allowlist is empty or too large, the integration is disconnected, or it is not Amplitude |
| `401` | Missing or invalid API key |
| `403` | The API key lacks `integrations:manage` |
| `404` | No integration with this ID in your company |

```json 200 theme={null}
{
  "success": true,
  "integration": {
    "id": "int_abc123",
    "provider": "amplitude",
    "name": "Amplitude",
    "eventSettings": {
      "syncAllEvents": false,
      "eventAllowlist": ["Song Played", "Plan Upgraded"],
      "skipInternalEvents": true
    },
    "cohorts": []
  },
  "eventSettings": {
    "syncAllEvents": false,
    "eventAllowlist": ["Song Played", "Plan Upgraded"],
    "skipInternalEvents": true
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.