Create webhook

This endpoint let you create or update a webhook that will get response each time somebody will complete your form.

PUT https://api.interankiety.pl/v1/forms/{form_id}/webhooks/{tag}

Query parameters

• url - Your desired url where we should send webhooks.

URL requirements

• It must start with https:// (recommended) or http://.
• Its host must be a public domain name or a public IP address. Addresses in private networks (for example localhost, 10.0.0.0/8, 192.168.0.0/16) are rejected with code 422.
• Redirects are not followed: your endpoint must answer at this URL, not redirect to another one.

Path parameters

• form_id - Id of form
• tag - name for webhook

Note

Your endpoint needs to give in respond 200 code so we know our payload was send successfully.

{
    "webhook": {
        "form_id": "formid",
        "tag": "eagle",
        "url": "https://my-url.com/get",
        "secret": "whsec_3f1c0e9a5b7d2e4f6a8c0b1d3e5f7a9c2b4d6e8f0a1c3e5b7d9f1a3c5e7b9d0f"
    }
}

Use secret to check that webhook calls come from Interankiety: see Verify webhook signature. Updating a webhook keeps its secret.