You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

仅使用SendGrid API能否构建完整的邮件列表订阅表单?

SendGrid 邮件列表订阅API请求规范

无需依赖第三方工具,直接调用SendGrid官方Marketing Contacts API即可实现自定义订阅表单功能,具体请求格式如下:

前期准备

  • 申请SendGrid API密钥,需开通 Marketing > Contacts 模块的写入权限
  • 在SendGrid后台创建目标邮件列表,获取对应的列表ID(List ID)

基础请求信息

请求方法:POST
请求地址:https://api.sendgrid.com/v3/marketing/contacts

请求头参数

  • Authorization: Bearer 替换为你的SendGrid API密钥
  • Content-Type: application/json

请求体示例

{
  "list_ids": [
    "替换为你获取的目标邮件列表ID"
  ],
  "contacts": [
    {
      "email": "用户提交的订阅邮箱地址",
      "first_name": "用户填写的名字(非必填)",
      "last_name": "用户填写的姓氏(非必填)",
      "custom_fields": {
        "自定义字段ID": "用户提交的自定义信息(非必填)"
      }
    }
  ]
}

常见返回状态说明

  • 202:请求受理成功,订阅信息将在几秒内同步到你的邮件列表,可判定为订阅提交成功
  • 401:API密钥无效或权限不足,请检查密钥是否开启了Marketing Contacts的写入权限
  • 400:参数格式错误,请检查邮箱格式、列表ID是否填写正确

建议在SendGrid后台开启双重订阅确认功能,用户点击确认邮件后才算正式订阅,可有效降低垃圾订阅概率,避免影响账号发信信誉。

内容的提问来源于stack exchange,提问作者BonisTech

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.28 03:45:03