---
title: "Tally Webhook"
method: POST
path: "/api/nps/webhooks/tally"
tags: ["nps"]
---

# Tally Webhook

`POST /api/nps/webhooks/tally`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/nps/webhooks/tally`
- Auth: none declared

Tally.so webhook handler (FREE survey platform)

Receives NPS survey responses from Tally.so and processes them

**Tally.so Webhook Setup:**
```
Tally Settings → Integrations → Webhooks
URL: https://api.ruzora.com/api/nps/webhooks/tally
Method: POST
Trigger: On form submission
```

**Payload Example:**
```json
{
    "eventType": "FORM_RESPONSE",
    "eventId": "xyz123",
    "createdAt": "2026-02-20T14:30:00Z",
    "data": {
        "responseId": "abc456",
        "submissionId": "def789",
        "formId": "YOUR_FORM_ID",
        "formName": "30-Day NPS Survey",
        "fields": [
            {
                "key": "question_1",
                "label": "On a scale of 0-10...",
                "type": "NUMBER",
                "value": 9
            },
            {
                "key": "question_2",
                "label": "What do you love most?",
                "type": "TEXTAREA",
                "value": "Juan is amazing!"
            },
            {
                "key": "placement_id",
                "type": "HIDDEN_FIELDS",
                "value": "recPlacement123"
            },
            {
                "key": "survey_type",
                "type": "HIDDEN_FIELDS",
                "value": "30_day"
            },
            {
                "key": "client_email",
                "type": "HIDDEN_FIELDS",
                "value": "sarah@acme.com"
            }
        ]
    }
}
```

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)