# Vic.ai Webhook Subscriptions API

**Canonical:** https://apis.io/apis/vicai/vicai-webhook-subscriptions-api/  
**Provider:** Vic.ai — https://apis.io/providers/vicai/  
**Base URL:** https://api.us.vic.ai  
**Documentation:** https://docs.vic.ai

Vic.ai Webhook Subscriptions API is one of 33 APIs that [Vic.ai](https://apis.io/providers/vicai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Webhook Subscriptions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Webhook subscriptions control which events your system receives and where they are delivered. Each company may have one V0 subscription or multiple V2 subscriptions. You can subscribe to all events or a specific subset. If you need to update your subscription to receive all events after trimming it down, pass `"events":["all"]` -- when using `all`, it must be set by itself. ## Partner Onboarding Flow Integration partners can programmatically provision new companies and configure webhook delivery using the V2 API: 1. **Create a company** — `POST /v2/companies` with the company's name, country code, and billing timezone. The new company is automatically linked to your OAuth client, inheriting the organization of your primary company (or specify `organization_id` explicitly). 2. **Create webhook subscriptions** — `POST /v2/companies/{company_id}/subscriptions` with your callback URL and the events you want to receive. 3. **Manage subscriptions** — use `GET`, `PUT`, or `DELETE` on `/v2/companies/{company_id}/subscriptions/{id}` as needed.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/vicai/refs/heads/main/openapi/vicai-webhook-subscriptions-api-openapi.yml
- **Documentation** — https://docs.vic.ai
- **APIReference** — https://docs.vic.ai

## Other Vic.ai APIs (12)

- [Vic.ai Accounts API](https://apis.io/apis/vicai/vicai-accounts-api/)
- [Vic.ai Allowed Senders API](https://apis.io/apis/vicai/vicai-allowed-senders-api/)
- [Vic.ai Attachments API](https://apis.io/apis/vicai/vicai-attachments-api/)
- [Vic.ai Authentication API](https://apis.io/apis/vicai/vicai-authentication-api/)
- [Vic.ai Beta Features API](https://apis.io/apis/vicai/vicai-beta-features-api/)
- [Vic.ai Bills API](https://apis.io/apis/vicai/vicai-bills-api/)
- [Vic.ai Companies API](https://apis.io/apis/vicai/vicai-companies-api/)
- [Vic.ai Company Settings API](https://apis.io/apis/vicai/vicai-company-settings-api/)
- [Vic.ai Credit Confirmations API](https://apis.io/apis/vicai/vicai-credit-confirmations-api/)
- [Vic.ai CSV Reports API](https://apis.io/apis/vicai/vicai-csv-reports-api/)
- [Vic.ai Dimensions API](https://apis.io/apis/vicai/vicai-dimensions-api/)
- [Vic.ai Email Endpoints API](https://apis.io/apis/vicai/vicai-email-endpoints-api/)

## Tags

Webhook Subscriptions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/vicai/vicai-webhook-subscriptions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/vicai/.