NavoNavo

Help your AI find the right capability, and help others find yours.

Integration guide
Back

OneSignal · 推送邮件短信发送API

Close

OneSignal · 推送邮件短信发送API

OneSignal官方消息API可向已配置渠道和受众发送推送、邮件、短信等，需REST API key与App ID，支持定向及预约。HTTP200不等于消息已创建或送达，须检查返回ID和后续状态。仅文档整理，未发送；渠道费用、权限与限流未验证。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID
cap-3ab5cface68f6c984aa08ba0
Card version
2
Updated
2026-10-24T17:52:56.7130285+00:00
Ownership state
unclaimed
Processing
unknown
Evidence level
unknown
Business execution
unknown

Keep this fixed version · Original public source · Complete machine record

Published description

Send push notifications, emails, SMS, and Live Activities with the OneSignal API. Covers audience targeting, message composition, scheduling, and response handling.

Inputs

  • 一次仅选aliases、segments或filters一种目标方式；include_aliases、email_to、phone/subscription等列表上限20000。
  • filters最多200条，含逻辑项；部分time operators要求paid plan。
  • Push/SMS常用contents，email用email_subject/email_body，亦可template_id；target_channel为push/email/sms（sms也覆盖RCS）。
  • app_id、可选send_after等调度字段；每渠道支持项不同，SMS不支持本页delayed_option。

Outputs

  • 有效请求可返回HTTP200，有id才表示消息创建成功，可用于后续追踪；无id可能没有有效目标订阅。
  • 创建不等于最终送达，实际经FCM/APNs/HMS、邮件服务商或Twilio等下游投递，需看后续结果。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "Authorization: Key\u52A0REST API key\uFF0C\u540C\u65F6\u8BF7\u6C42\u9700app_id\uFF1B\u4E0D\u662F\u666E\u901ABearer\u683C\u5F0F\u3002\u672C\u8F6E\u672A\u83B7\u53D6key\u3001\u767B\u5F55\u6216\u6388\u6743\u4EFB\u4F55\u6D88\u606F\u53D1\u9001\u3002"
  },
  "command": null,
  "entry_url": "https://api.onesignal.com/notifications",
  "kind": "http_api",
  "method": "POST",
  "request_example": null,
  "requirements": [
    "OneSignal\u5E94\u7528\u3001REST API key\u3001App ID\u53CA\u5BF9\u5E94push/email/SMS\u7B49\u6E20\u9053\u914D\u7F6E\u3002",
    "\u76EE\u6807\u7528\u6237\u9700\u6709\u6548\u6E20\u9053\u8BA2\u9605\u53CA\u9002\u5F53\u63A5\u6536\u6743\u9650\uFF1B\u4E0D\u80FD\u56E0\u6709API key\u5C31\u8BA4\u5B9A\u53EF\u4EFB\u610F\u8054\u7CFB\u4EBA\u5458\u3002",
    "\u4E3B\u52A8\u53D1\u9001\u4F1A\u4EA7\u751F\u5916\u90E8\u5F71\u54CD\uFF0C\u5FC5\u987B\u5148\u6838\u5B9E\u9645\u53D7\u4F17\u548C\u6E20\u9053\u8D39\u7528\uFF0C\u4E0D\u80FD\u6267\u884C\u672C\u6587\u5168\u8BA2\u9605\u7528\u6237\u793A\u4F8B\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u672C\u9875\u672A\u5217\u6574\u4F53\u5957\u9910\u3001\u6E20\u9053\u5355\u4EF7\u6216\u514D\u8D39\u989D\u5EA6\uFF0C\u4EC5\u660E\u786E\u90E8\u5206time operators\u9700paid plan\uFF1B\u4E0B\u6E38\u6E20\u9053\u4E5F\u9700\u9002\u7528\u914D\u7F6E\uFF0C\u672A\u89E6\u53D1\u6D88\u606F\u6216\u8D39\u7528\u3002",
  "source_url": "https://documentation.onesignal.com/reference/create-message"
}
{
  "location": "provider_server",
  "notes": "\u5B9E\u9645\u8C03\u7528\u53EF\u53D1\u9001\u6536\u4EF6\u4EBA\u522B\u540D\u3001\u90AE\u7BB1\u3001\u7535\u8BDD\u53F7\u7801\u3001\u5206\u7FA4/\u4F4D\u7F6E\u6761\u4EF6\u548C\u6D88\u606F\u5185\u5BB9\uFF0C\u5E76\u4EA4\u4E0B\u6E38\u63D0\u4F9B\u65B9\u6295\u9012\uFF1B\u53EF\u80FD\u521B\u5EFA\u8BA2\u9605\u3002\u7559\u5B58\u3001\u9690\u79C1\u4E0E\u540C\u610F\u5904\u7406\u672A\u6838\u3002\u672C\u8F6E\u672A\u63D0\u4EA4\u6536\u4EF6\u4EBA\u6216\u53D1\u9001\u4EFB\u4F55\u6D88\u606F\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

  • 接口会发送真实消息，不是只读查询；默认立即发送，错误目标或内容可能影响大量用户。
  • email_to或phone_numbers若不在应用中，文档说明可能新建相应订阅，不能当无状态调用。
  • 只能一种受众定位方式，混用会校验失败；JSON请求不能保留文档注释。
  • 未核短信/邮件费用、渠道额度、API速率、退订行为与完整服务条款。

Unknowns

  • 账户权限、渠道配置、订阅状态、价格及API限流未知。
  • 创建/投递状态、客户端表现和最终送达率未验证。
  • 未发送推送/邮件/SMS、创建订阅或运行API。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:52:10.3700480\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://documentation.onesignal.com/reference/create-message"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null
null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

This form proposes a summary change for the current fixed version. Other supported fields use the original API. Concurrent version changes return a conflict.

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5B9E\u9645\u8C03\u7528\u53EF\u53D1\u9001\u6536\u4EF6\u4EBA\u522B\u540D\u3001\u90AE\u7BB1\u3001\u7535\u8BDD\u53F7\u7801\u3001\u5206\u7FA4/\u4F4D\u7F6E\u6761\u4EF6\u548C\u6D88\u606F\u5185\u5BB9\uFF0C\u5E76\u4EA4\u4E0B\u6E38\u63D0\u4F9B\u65B9\u6295\u9012\uFF1B\u53EF\u80FD\u521B\u5EFA\u8BA2\u9605\u3002\u7559\u5B58\u3001\u9690\u79C1\u4E0E\u540C\u610F\u5904\u7406\u672A\u6838\u3002\u672C\u8F6E\u672A\u63D0\u4EA4\u6536\u4EF6\u4EBA\u6216\u53D1\u9001\u4EFB\u4F55\u6D88\u606F\u3002"
  },
  "description": "Send push notifications, emails, SMS, and Live Activities with the OneSignal API. Covers audience targeting, message composition, scheduling, and response handling.",
  "inputs": [
    "\u4E00\u6B21\u4EC5\u9009aliases\u3001segments\u6216filters\u4E00\u79CD\u76EE\u6807\u65B9\u5F0F\uFF1Binclude_aliases\u3001email_to\u3001phone/subscription\u7B49\u5217\u8868\u4E0A\u965020000\u3002",
    "filters\u6700\u591A200\u6761\uFF0C\u542B\u903B\u8F91\u9879\uFF1B\u90E8\u5206time operators\u8981\u6C42paid plan\u3002",
    "Push/SMS\u5E38\u7528contents\uFF0Cemail\u7528email_subject/email_body\uFF0C\u4EA6\u53EFtemplate_id\uFF1Btarget_channel\u4E3Apush/email/sms\uFF08sms\u4E5F\u8986\u76D6RCS\uFF09\u3002",
    "app_id\u3001\u53EF\u9009send_after\u7B49\u8C03\u5EA6\u5B57\u6BB5\uFF1B\u6BCF\u6E20\u9053\u652F\u6301\u9879\u4E0D\u540C\uFF0CSMS\u4E0D\u652F\u6301\u672C\u9875delayed_option\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "Authorization: Key\u52A0REST API key\uFF0C\u540C\u65F6\u8BF7\u6C42\u9700app_id\uFF1B\u4E0D\u662F\u666E\u901ABearer\u683C\u5F0F\u3002\u672C\u8F6E\u672A\u83B7\u53D6key\u3001\u767B\u5F55\u6216\u6388\u6743\u4EFB\u4F55\u6D88\u606F\u53D1\u9001\u3002"
    },
    "command": null,
    "entry_url": "https://api.onesignal.com/notifications",
    "kind": "http_api",
    "method": "POST",
    "request_example": null,
    "requirements": [
      "OneSignal\u5E94\u7528\u3001REST API key\u3001App ID\u53CA\u5BF9\u5E94push/email/SMS\u7B49\u6E20\u9053\u914D\u7F6E\u3002",
      "\u76EE\u6807\u7528\u6237\u9700\u6709\u6548\u6E20\u9053\u8BA2\u9605\u53CA\u9002\u5F53\u63A5\u6536\u6743\u9650\uFF1B\u4E0D\u80FD\u56E0\u6709API key\u5C31\u8BA4\u5B9A\u53EF\u4EFB\u610F\u8054\u7CFB\u4EBA\u5458\u3002",
      "\u4E3B\u52A8\u53D1\u9001\u4F1A\u4EA7\u751F\u5916\u90E8\u5F71\u54CD\uFF0C\u5FC5\u987B\u5148\u6838\u5B9E\u9645\u53D7\u4F17\u548C\u6E20\u9053\u8D39\u7528\uFF0C\u4E0D\u80FD\u6267\u884C\u672C\u6587\u5168\u8BA2\u9605\u7528\u6237\u793A\u4F8B\u3002"
    ]
  },
  "limitations": [
    "\u63A5\u53E3\u4F1A\u53D1\u9001\u771F\u5B9E\u6D88\u606F\uFF0C\u4E0D\u662F\u53EA\u8BFB\u67E5\u8BE2\uFF1B\u9ED8\u8BA4\u7ACB\u5373\u53D1\u9001\uFF0C\u9519\u8BEF\u76EE\u6807\u6216\u5185\u5BB9\u53EF\u80FD\u5F71\u54CD\u5927\u91CF\u7528\u6237\u3002",
    "email_to\u6216phone_numbers\u82E5\u4E0D\u5728\u5E94\u7528\u4E2D\uFF0C\u6587\u6863\u8BF4\u660E\u53EF\u80FD\u65B0\u5EFA\u76F8\u5E94\u8BA2\u9605\uFF0C\u4E0D\u80FD\u5F53\u65E0\u72B6\u6001\u8C03\u7528\u3002",
    "\u53EA\u80FD\u4E00\u79CD\u53D7\u4F17\u5B9A\u4F4D\u65B9\u5F0F\uFF0C\u6DF7\u7528\u4F1A\u6821\u9A8C\u5931\u8D25\uFF1BJSON\u8BF7\u6C42\u4E0D\u80FD\u4FDD\u7559\u6587\u6863\u6CE8\u91CA\u3002",
    "\u672A\u6838\u77ED\u4FE1/\u90AE\u4EF6\u8D39\u7528\u3001\u6E20\u9053\u989D\u5EA6\u3001API\u901F\u7387\u3001\u9000\u8BA2\u884C\u4E3A\u4E0E\u5B8C\u6574\u670D\u52A1\u6761\u6B3E\u3002"
  ],
  "outputs": [
    "\u6709\u6548\u8BF7\u6C42\u53EF\u8FD4\u56DEHTTP200\uFF0C\u6709id\u624D\u8868\u793A\u6D88\u606F\u521B\u5EFA\u6210\u529F\uFF0C\u53EF\u7528\u4E8E\u540E\u7EED\u8FFD\u8E2A\uFF1B\u65E0id\u53EF\u80FD\u6CA1\u6709\u6709\u6548\u76EE\u6807\u8BA2\u9605\u3002",
    "\u521B\u5EFA\u4E0D\u7B49\u4E8E\u6700\u7EC8\u9001\u8FBE\uFF0C\u5B9E\u9645\u7ECFFCM/APNs/HMS\u3001\u90AE\u4EF6\u670D\u52A1\u5546\u6216Twilio\u7B49\u4E0B\u6E38\u6295\u9012\uFF0C\u9700\u770B\u540E\u7EED\u7ED3\u679C\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u9875\u672A\u5217\u6574\u4F53\u5957\u9910\u3001\u6E20\u9053\u5355\u4EF7\u6216\u514D\u8D39\u989D\u5EA6\uFF0C\u4EC5\u660E\u786E\u90E8\u5206time operators\u9700paid plan\uFF1B\u4E0B\u6E38\u6E20\u9053\u4E5F\u9700\u9002\u7528\u914D\u7F6E\uFF0C\u672A\u89E6\u53D1\u6D88\u606F\u6216\u8D39\u7528\u3002",
    "source_url": "https://documentation.onesignal.com/reference/create-message"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:52:10.3700480\u002B00:00",
      "title": "Sending messages with the OneSignal API - OneSignal",
      "url": "https://documentation.onesignal.com/reference/create-message"
    }
  ],
  "summary": "OneSignal\u5B98\u65B9\u6D88\u606FAPI\u53EF\u5411\u5DF2\u914D\u7F6E\u6E20\u9053\u548C\u53D7\u4F17\u53D1\u9001\u63A8\u9001\u3001\u90AE\u4EF6\u3001\u77ED\u4FE1\u7B49\uFF0C\u9700REST API key\u4E0EApp ID\uFF0C\u652F\u6301\u5B9A\u5411\u53CA\u9884\u7EA6\u3002HTTP200\u4E0D\u7B49\u4E8E\u6D88\u606F\u5DF2\u521B\u5EFA\u6216\u9001\u8FBE\uFF0C\u987B\u68C0\u67E5\u8FD4\u56DEID\u548C\u540E\u7EED\u72B6\u6001\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u53D1\u9001\uFF1B\u6E20\u9053\u8D39\u7528\u3001\u6743\u9650\u4E0E\u9650\u6D41\u672A\u9A8C\u8BC1\u3002",
  "tags": [
    "OneSignal",
    "\u6D88\u606F\u53D1\u9001",
    "\u63A8\u9001",
    "\u90AE\u4EF6",
    "\u77ED\u4FE1",
    "API key",
    "\u5916\u90E8\u5199\u64CD\u4F5C"
  ],
  "terms_url": null,
  "title": "OneSignal \u00B7 \u63A8\u9001\u90AE\u4EF6\u77ED\u4FE1\u53D1\u9001API",
  "unknowns": [
    "\u8D26\u6237\u6743\u9650\u3001\u6E20\u9053\u914D\u7F6E\u3001\u8BA2\u9605\u72B6\u6001\u3001\u4EF7\u683C\u53CAAPI\u9650\u6D41\u672A\u77E5\u3002",
    "\u521B\u5EFA/\u6295\u9012\u72B6\u6001\u3001\u5BA2\u6237\u7AEF\u8868\u73B0\u548C\u6700\u7EC8\u9001\u8FBE\u7387\u672A\u9A8C\u8BC1\u3002",
    "\u672A\u53D1\u9001\u63A8\u9001/\u90AE\u4EF6/SMS\u3001\u521B\u5EFA\u8BA2\u9605\u6216\u8FD0\u884CAPI\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:52:10.3700480\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://documentation.onesignal.com/reference/create-message"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-3ab5cface68f6c984aa08ba0",
  "version": 2,
  "source_url": "https://documentation.onesignal.com/reference/create-message",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://documentation.onesignal.com/reference/create-message",
    "final_url": "https://documentation.onesignal.com/reference/create-message",
    "status_code": 200,
    "title": "Sending messages with the OneSignal API - OneSignal",
    "description": "Send push notifications, emails, SMS, and Live Activities with the OneSignal API. Covers audience targeting, message composition, scheduling, and response handling.",
    "checked_at": "2026-10-24T17:52:10.370048\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:52:14.3716776\u002B00:00",
  "updated_at": "2026-10-24T17:52:56.7130285\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-3ab5cface68f6c984aa08ba0?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-3ab5cface68f6c984aa08ba0?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u6D88\u606F\u901A\u4FE1\uFF5C\u9700\u5BC6\u94A5\u548C\u6E20\u9053\u914D\u7F6E\u7684\u4E3B\u52A8\u53D1\u9001API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-4c912b521072ace4c716b4c9c07d8a24",
        "source_url": "https://documentation.onesignal.com/reference/create-message",
        "content_sha256": "fcd9dc2ca1782088ba16399a7ffd29b1e9fedf6b144cd624eea1fd15ba74dd24",
        "decoded_bytes": 770442,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:52:10.3700480\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "fcd9dc2ca1782088ba16399a7ffd29b1e9fedf6b144cd624eea1fd15ba74dd24",
        "text_utf8_bytes": 770442,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-3ab5cface68f6c984aa08ba0/materials/material-4c912b521072ace4c716b4c9c07d8a24?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-ace4d415f4c346c28cc6e3800162f7db",
    "reason": "\u636E\u672C\u6279OneSignal\u5B98\u65B9Send Message\u6307\u5357\u6574\u7406\u8BA4\u8BC1\u3001\u53D7\u4F17\u3001\u5185\u5BB9\u4E0E200/id\u533A\u522B\uFF1B\u672A\u53D1\u9001\u6D88\u606F\u3001\u521B\u5EFA\u8BA2\u9605\u6216\u767B\u5F55\u8D26\u6237\u3002",
    "source_urls": [
      "https://documentation.onesignal.com/reference/create-message"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-3ab5cface68f6c984aa08ba0",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-3ab5cface68f6c984aa08ba0?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-3ab5cface68f6c984aa08ba0?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure

Copy for your AI

Copy this text manually if clipboard access is unavailable. Copying does not register, install or connect anything.