---
title: "Create Event"
method: POST
path: "/v1/installations/{integrationConfigurationId}/events"
tags: ["marketplace"]
---

# Create Event

`POST /v1/installations/{integrationConfigurationId}/events`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/installations/{integrationConfigurationId}/events`
- Auth: HTTP bearer

Partner notifies Vercel of any changes made to an Installation or a Resource. Vercel is expected to use `list-resources` and other read APIs to get the new state.<br/> <br/> `resource.updated` event should be dispatched when any state of a resource linked to Vercel is modified by the partner.<br/> `installation.updated` event should be dispatched when an installation's billing plan is changed via the provider instead of Vercel.<br/> <br/> Resource update use cases: <br/> <br/> - The user renames a database in the partner’s application. The partner should dispatch a `resource.updated` event to notify Vercel to update the resource in Vercel’s datastores.<br/> - A resource has been suspended due to a lack of use. The partner should dispatch a `resource.updated` event to notify Vercel to update the resource's status in Vercel's datastores.<br/>

## Path parameters

- `integrationConfigurationId` string, required

## Request body

- object
  - `event` union, required
    - object
      - `type` 'installation.updated', required
      - `billingPlanId` string: The installation-level billing plan ID
    - object
      - `type` 'resource.updated', required
      - `productId` string: Partner-provided product slug or id
      - `resourceId` string, required: Partner provided resource ID

## Response `201`

## Other responses

- `400`: One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-01-22** `c12186034433`: 1 breaking
  - request body became required
- **2025-11-28** `45991e5c8b6d`: 1 info
  - the request property `event/oneOf[subschema #2]/productId` became optional
- **2025-10-09** `50caddad4ae7`: 1 info
  - added the non-success response with the status `404`
- **2025-03-19** `37b482c58c92`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/installations/:integrationConfigurationId/events/post.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)