Change a webhook subscription

PUT/subscriptions/{id}

Last modified: 2 months ago

Request

Path Params

string

required

Header Params

X-Integration-Name

string

required

Integration name

Example:

API Documentation

X-Integration-Provider

string

required

Integration provider

Example:

cobra GmbH

X-Cobra-TenantId

string

required

Tenant ID

Example:

12e39e53-ece1-4d8d-8958-e782de1dbef0

X-Integration-Contact

string

optional

Integration contact

Example:

info@cobra.de

caption

string

required

Caption

>= 1 characters

Example:

My subscription

webhookId

string <uuid>

required

Webhook ID

>= 1 characters

Example:

80f48afa-4927-43de-9d0d-24cf4aba53cf

method

enum<string>

required

Allowed values:

POSTGET

url

string

required

Webhook URL

>= 1 characters

Example:

https://www.cobra.de

errorEmail

string <email>

required

E-mail for error notifications

>= 1 characters

Example:

error@cobra.de

payload

string | null

optional

JSON-Payload (must be valid JSON)

headers

object | null

optional

HTTP-Headers (Header names must be valid)

Additional properties

string | null

optional

{
  "caption": "Event created",
  "webhookId": "80f48afa-4927-43de-9d0d-24cf4aba53cf",
  "method": "POST",
  "url": "https://www.mytesturl.de",
  "errorEmail": "error@cobra.de",
  "payload": "{\"firstName\": \"John\",\"lastName\": \"doe\",\"EventNumber\": \"<EventNumber>\"}",
  "headers": {
    "MyHeader1": "HeaderValue1",
    "MyHeader2": "HeaderValue2"
  }
}

Request samples

Responses

Success(200)

Not Found(404)

HTTP Code: 200

Content Type : JSONapplication/json

data

object (Subscription)

optional

Indicates the current subscription for the tenant

tariff

string <uuid>

optional

Tariff Id

Example:

95e95b33-6e9c-402d-beae-b0d06c74b199

tariffVersion

integer <int32>

optional

Tariff version

Example:

trial

boolean

optional

Indicates whether the tenant is in trial mode

Example:

false

trialEnd

string <date-time> | null

optional

Indicates when the trial mode ends

Example:

2024-01-10T15:06:25.355Z

lockout

boolean

optional

Indicates whether the tenant is locked

Example:

false

lockoutReason

enum<string>

optional

Allowed values:

EmptyTrialExpiredPaymentIssueSubscriptionDeleted

subscriptionId

string | null

optional

Subscription identifier which is active for the tenant

customerId

string | null

optional

Customer identifier which is assigned to the tenant

connectAccountId

string | null

optional

If the tenant is connected to a cobra partner, this is the id to the partners account. Otherwise it is empty.

daysLeft

integer <int32>

read-onlyoptional

If it is a trial version, the remaining days of the trial version are displayed here

message

string | null

optional

metaData

object (ResponseMetaData)

optional

totalResults

integer <int32>

optional

responseTimeStamp

string <date-time>

optional

statusCode

integer <int32>

optional

{
  "data": {
    "id": "18d893cb-bbdc-4d3d-b5e3-f609c8c5422a",
    "dateCreate": "2024-10-09T07:00:39.1437701+00:00",
    "dateModified": "2024-10-09T07:00:39.1437705+00:00",
    "caption": "Event created",
    "webhookId": "80f48afa-4927-43de-9d0d-24cf4aba53cf",
    "method": "POST",
    "url": "https://www.mytesturl.de",
    "errorEmail": "error@cobra.de",
    "payload": "{\"firstName\": \"John\",\"lastName\": \"doe\",\"EventNumber\": \"<EventNumber>\"}",
    "headers": {
      "MyHeader1": "HeaderValue1",
      "MyHeader2": "HeaderValue2"
    }
  },
  "message": "",
  "metaData": null,
  "statusCode": 200
}

Last modified: 2 months ago