GET /clients/webhook

Returns the webhook URL currently registered for the authenticated client. The secret key is never returned. API Gateway scopes the request from the bearer token and forwards the authenticated client and identity to checkout; do not send conomyhq-client-id manually.

GET/clients/webhook

Get webhook configuration

Headers

Bearer access token returned by the authentication endpoint.

The API key used for authentication when making requests to the API Gateway.

API version selector for Conomy endpoints. Use 24-04-2025 for the current version.

Identifies the application making the request.

Query parameters

Optional webhook slot to read. Omit it to return the default URL plus the configured per-flavor slots. Use cvu.static when a fixed CVU is provided by the client and cvu.dynamic when Conomy creates the CVU.

defaultcvu.staticcvu.dynamic

Responses

webhookUrlstringuri

Default webhook URL.

flavorstring

defaultcvu.staticcvu.dynamic

sourceFlavorstring

defaultcvu.staticcvu.dynamic

flavorsobject

Per-flavor webhook URLs keyed by flavor.

metadataobject

Request

GET /sandbox/clients/webhook HTTP/1.1
Host: api.conomyhq.com
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {YOUR_API_KEY}
conomyhq-api-version: 24-04-2025
User-Agent: MyApp/1.0

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.conomyhq.com/sandbox/clients/webhook", nil)
	req.Header.Set("Authorization", "Bearer {ACCESS_TOKEN}")
	req.Header.Set("x-api-key", "{YOUR_API_KEY}")
	req.Header.Set("conomyhq-api-version", "24-04-2025")
	req.Header.Set("User-Agent", "MyApp/1.0")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()

	var data map[string]any
	json.NewDecoder(resp.Body).Decode(&data)
}

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let resp = client
        .get("https://api.conomyhq.com/sandbox/clients/webhook")
        .header("Authorization", "Bearer {ACCESS_TOKEN}")
        .header("x-api-key", "{YOUR_API_KEY}")
        .header("conomyhq-api-version", "24-04-2025")
        .header("User-Agent", "MyApp/1.0")
        .send()
        .await?;

    let data: serde_json::Value = resp.json().await?;
    Ok(())
}

Response

{
  "webhookUrl": "https://example.com/webhook",
  "flavor": "default",
  "sourceFlavor": "default",
  "flavors": {},
  "metadata": {}
}