Quickstart

export POLYMORFA_BASE_URL="https://api.polymorfa.com"
export POLYMORFA_PROJECT_ID="replace-with-project-id"

export POLYMORFA_KEY="pmfa_REPLACE_ME"

curl -X POST "$POLYMORFA_BASE_URL/messaging/quicklinks" \
  -H "Authorization: Bearer $POLYMORFA_KEY" \
  -H "Polymorfa-Version: 2026-09-22" \
  -H "Content-Type: application/json" \
  -d "{\"projectId\":\"$POLYMORFA_PROJECT_ID\",\"settings\":{\"methods\":[\"qr\",\"pairing\"],\"businessName\":\"Acme\"}}"

export POLYMORFA_SESSION="quicklink-replace_me"

curl -X POST "$POLYMORFA_BASE_URL/messaging/$POLYMORFA_SESSION/messages/send" \
  -H "Authorization: Bearer $POLYMORFA_KEY" \
  -H "Polymorfa-Version: 2026-09-22" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phoneNumber": "+5511999999999" },
    "content": { "text": "Hello from Polymorfa" }
  }'

curl -X POST "$POLYMORFA_BASE_URL/api/webhooks" \
  -H "Authorization: Bearer $POLYMORFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/polymorfa/webhook",
    "events": ["message.received", "message.ack", "session.status"],
    "hmacKey": "replace-with-a-random-secret",
    "format": "native"
  }'