Skip to content
KivraAPI Reference
This is a new version of the Kivra Developer Docs. Report issues or share feedback at avsandare.support@kivra.se. The previous version can be found here.

Notification for new content

POST

This webhook notifies you when a company inbox receives new content.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
id
required
WebhookEventId

Event ID prefixed with “event_”. Can be used for deduplication.

string
Example
event_3f62fc97907a4212af028c30f1ea1927
event_created_at
required
WebhookEventCreatedAt

Unix timestamp when the event happened, in seconds (UTC).

integer format: int64
Example
1686089970
event_type
required
string
Allowed values: content.created
data_version
required
integer
Allowed values: 1
data
required
object
company_key
required
CompanyKey

The key for a company

string
/^[0-9]{10}[a-f0-9]{32}$/
Example
156077433683911cdca5fd4563bded979572454cb9
content_key
required
ContentKey

The key for a content

string
/^[0-9]{10}[a-f0-9]{32}$/
Example
156077433683911cdca5fd4563bded979572454cb9
vat_number
required

The VAT number of the company that received the content.

string
/^SE[0-9]{10}01$/
Example
SE556000475501

Responses

Section titled “Responses”

200

Section titled “200”

Return a 200 status to acknowledge receipt of the webhook. Any other response will cause Kivra to retry the delivery.