Double Your Survey Response Rates

import requests

API = "https://api.multimail.dev/v1"
HEADERS = {"Authorization": "Bearer mm_live_xxx"}

def send_survey_invitation(recipient: dict, survey_url: str):
    response = requests.post(
        f"{API}/send",
        headers=HEADERS,
        json={
            "from": "[email protected]",
            "to": [recipient["email"]],
            "subject": "2 minutes: Help us improve our API documentation",
            "text_body": (
                f"Hi {recipient[&"cm">#039;name']},\n\n"
                f"As an active API user, your feedback would be incredibly "
                f"valuable. This 2-minute survey covers our documentation "
                f"quality, code examples, and search experience.\n\n"
                f"Take the survey: {survey_url}?ref={recipient[&"cm">#039;id']}\n\n"
                f"Your responses directly influence our Q2 documentation "
                f"roadmap. Every response matters.\n\n"
                f"Thanks,\nProduct Team"
            ),
            "html_body": f"<p>Hi {recipient[&"cm">#039;name']}...</p>"
        }
    )
    return response.json()

# Send to targeted audience
audience = requests.get(
    f"{API}/contacts/search",
    headers=HEADERS,
    params={"query": "api-user active"}
).json()

for recipient in audience["results"]:
    send_survey_invitation(recipient, "https://survey.yourcompany.com/api-docs")

import requests

API = "https://api.multimail.dev/v1"
HEADERS = {"Authorization": "Bearer mm_live_xxx"}

"cm"># Find contacts tagged as survey-sent but not survey-completed
non_respondents = requests.get(
    f"{API}/contacts/search",
    headers=HEADERS,
    params={"query": "survey-sent -survey-completed api-docs-2026"}
).json()

for recipient in non_respondents["results"]:
    response = requests.post(
        f"{API}/send",
        headers=HEADERS,
        json={
            "from": "[email protected]",
            "to": [recipient["email"]],
            "subject": "Quick reminder: Your feedback helps shape our docs (2 min)",
            "text_body": (
                f"Hi {recipient[&"cm">#039;name']},\n\n"
                f"Just a friendly reminder — we&"cm">#039;d love your input on our "
                f"API documentation. Only 2 minutes.\n\n"
                f"Take the survey: https://survey.yourcompany.com/api-docs?ref={recipient[&"cm">#039;id']}"
            )
        }
    )

"cm">// Find target audience
const audience = await mcp.search_contacts({
  query: "api-user active",
  limit: 200
});

"cm">// Send personalized invitations
for (const recipient of audience.results) {
  const result = await mcp.send_email({
    to: recipient.email,
    subject: "2 minutes: Help us improve our API docs",
    text_body: `Hi ${recipient.name}, as an active API user...`
  });

  await mcp.tag_email({
    email_id: result.id,
    tags: ["survey", "api-docs-2026", "initial-send"]
  });
}

console.log(`Sent ${audience.results.length} survey invitations`);