Skip to content

Webhooks

Fresh

GEELark pushes operation results to developers via webhooks. Set your callback URL to receive real-time notifications.

Set Webhook URL

URL: https://openapi.geelark.com/open/v1/callback/setMethod: POST

ParameterRequiredTypeDescription
urlYesstringCallback interface URL
json
{ "url": "http://example.geelark.com/phone/callback/test" }

Get Webhook URL

URL: https://openapi.geelark.com/open/v1/callback/getMethod: POST

No request parameters required.

json
{
  "code": 0,
  "data": {
    "url": "http://example.geelark.com/phone/callback/test"
  }
}

Authentication

Webhook callbacks use the same authentication as the GEELark API. Your callback endpoint must:

  1. Accept POST requests
  2. Handle request header authentication (Token or Key verification)
  3. Set Content-Type to application/json

Error Codes

CodeDescription
51001Callback URL not set

GEELark API Documentation - Built with VitePress