> ## Documentation Index
> Fetch the complete documentation index at: https://jupiter-feat-jupiterz-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook Integration (V1)

> Provide RFQ liquidity to JupiterZ by hosting a quote-and-swap webhook.

This guide covers how to provide liquidity to JupiterZ, Jupiter's RFQ (Request For Quote) system, using the V1 webhook model. You host a webhook implementing the RFQ API schema, Jupiter sends it quote requests and taker-signed transactions, and your system co-signs and lands the fills.

<Note>
  V1 (webhook) and [V2 (gRPC streaming)](/swap/routing/rfq/v2/streaming) run concurrently. V2 does not replace V1: you can integrate with either or both. They sit in different parts of Jupiter's stack: V1 works directly in the JupiterZ program and APIs (your quotes are served on the JupiterZ paths and fills settle through the [Order Engine program](/swap/routing/rfq/v1/settlement#order-engine)), while V2 streams orderbooks that Metis consumes, with fills executing through the Jupiter v6 swap aggregator program.
</Note>

<Frame>
  <img src="https://mintcdn.com/jupiter-feat-jupiterz-docs/gum74W1r54BpTxz9/static/images/rfq-flow.png?fit=max&auto=format&n=gum74W1r54BpTxz9&q=85&s=154a2db9e8516ff5633769769fbb9866" alt="RFQ Flow" width="803" height="904" data-path="static/images/rfq-flow.png" />
</Frame>

## Integration process

1. Host a service that implements the RFQ webhook API schema, see [Webhook API](/swap/routing/rfq/v1/webhook-api).
2. Complete the acceptance and integration tests from the [rfq-webhook-toolkit](https://github.com/jup-ag/rfq-webhook-toolkit).
3. Register your webhook with Jupiter. You will be onboarded to Edge (pre-production) before going live.

The [rfq-webhook-toolkit](https://github.com/jup-ag/rfq-webhook-toolkit) repository owns the code-level mechanics:

* [Sample server](https://github.com/jup-ag/rfq-webhook-toolkit/tree/main/server-example): a Rust implementation of the webhook API.
* [OpenAPI schema](https://github.com/jup-ag/rfq-webhook-toolkit/tree/main/openapi): the exact request and response shapes for every endpoint.
* [Integration tests](https://github.com/jup-ag/rfq-webhook-toolkit/tree/main/tests): acceptance tests (offline, against your webhook) and integration tests (against Edge, real mainnet swaps).
* [Troubleshooting](https://github.com/jup-ag/rfq-webhook-toolkit/blob/main/tests/README.md#troubleshooting): common issues during integration.

<Info>
  To register your webhook and begin onboarding, submit a request through the [support form](https://support.jup.ag/requests/new). For pre-integration questions, ask in the [developer support channel](https://discord.com/channels/897540204506775583/910250162402779146) on Discord.
</Info>

## Continue

<CardGroup cols={2}>
  <Card title="Webhook API" href="/swap/routing/rfq/v1/webhook-api">
    The endpoints your service implements, response codes, timeouts, token advertising, and IDs.
  </Card>

  <Card title="Quoting and fills" href="/swap/routing/rfq/v1/quoting">
    Fulfillment requirements, quote expiry, and how fees are applied.
  </Card>

  <Card title="Settlement and special cases" href="/swap/routing/rfq/v1/settlement">
    The Order Engine program, Squads multisig takers, the circuit breaker, and testing.
  </Card>

  <Card title="Streaming Integration (V2)" href="/swap/routing/rfq/v2/streaming">
    The gRPC streaming model, an alternative that runs concurrently with V1.
  </Card>
</CardGroup>