Skip to main content

​
1. Install NextKS in your workspace

  1. Sign in at app.nextks.com
  2. Click Add to Slack and authorize the app
  3. The NextKS bot will appear in your workspace

​
2. Generate an API key

  1. Go to Account in the NextKS dashboard
  2. Under API Keys, click Create Key
  3. Copy the key — it will only be shown once
Store your API key securely. It cannot be retrieved after creation.

​
3. Send your first notification

curl -X POST https://app.nextks.com/api/notify \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "user_emails": ["[email protected]"],
    "message": "Hello from the NextKS API!"
  }'
A successful response: 
{ "status": "ok" }
The recipient will see the message as a DM from the NextKS bot in Slack or Teams.

​
4. Send an interactive notification

curl -X POST https://app.nextks.com/api/notify \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "user_emails": ["[email protected]"],
    "message": "Deploy v2.4.1 to production?",
    "response_request": {
      "options": [
        { "text": "Approve", "value": "approve" },
        { "text": "Reject", "value": "reject" }
      ],
      "timeout_minutes": 30
    }
  }'
Response: 
{ "status": "ok", "request_id": "req_abc123..." }
Use the request_id to check response status or configure a callback for automatic delivery.

​
Next steps

API Authentication

Learn about API key management and authentication

Interactive Notifications

Build approval workflows with response buttons

Slack Setup

Detailed Slack installation guide

Teams Setup

Detailed Microsoft Teams installation guide