# Deployment Events

## Post a deployment event to ilert.

> Use the Deployment events API to integrate your CI & CD tools or custom deployment workflows with ilert. Create a new deployment pipeline to generate an integration key for this endpoint.

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.3-r.4"},"tags":[{"name":"Deployment Events"}],"servers":[{"url":"/api"}],"security":[],"paths":{"/deployment-events":{"post":{"tags":["Deployment Events"],"summary":"Post a deployment event to ilert.","description":"Use the Deployment events API to integrate your CI & CD tools or custom deployment workflows with ilert. Create a new deployment pipeline to generate an integration key for this endpoint.","requestBody":{"description":"The event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeploymentEvent"}}},"required":true},"responses":{"202":{"description":"The event has been accepted","content":{}}}}}},"components":{"schemas":{"DeploymentEvent":{"type":"object","required":["integrationKey","summary"],"properties":{"integrationKey":{"type":"string"},"summary":{"type":"string"},"timestamp":{"type":"integer","format":"int64"},"userEmail":{"description":"Optional email used to map the event to a specific user in ilert","type":"string","format":"email"},"customDetails":{"type":"object","additionalProperties":true},"links":{"type":"array","items":{"$ref":"#/components/schemas/EventLink"}}}},"EventLink":{"type":"object","properties":{"href":{"type":"string"},"text":{"type":"string"}}}}}}
```