← Home

Settings

Workspace: rockstarr-test

Contact-ingest webhook

One URL per workspace. Point Zapier / Make / n8n / custom code here to upsert contacts. The secret in the URL is the credential — treat it like a password.

POST URL

https://api.rockstarr.ai/api/v1/public/webhooks/contacts/vy_3NObtT5gHqjHLp-K2ZdgFgdI5ulRF
Payload shape
{
  "email":           "required",
  "name":            "optional combined; gets split on first space",
  "first_name":      "optional, wins over name",
  "last_name":       "optional, wins over name",
  "tags":            ["applied additively"],
  "remove_tags":     ["applied after tags"],
  "custom_fields":   { "free-form": "values" },
  "pipeline_stage":  "optional"
}

Always returns 200 { ok: true }, even on an invalid secret (no oracle for valid vs. invalid). Tag mutations from this endpoint flow through the normal trigger pipeline — automations listening for tag_added fire as soon as the contact lands.

Do this in chat:

  • "rotate my webhook secret"
  • "show me my webhook URL"

Rotating immediately invalidates the URL above. Every existing integration breaks until updated.