Responses

Success Response

Status code: 200 OK

{
  "success": true,
  "result": {
    "name": "projects/{project-id}/messages/{message-id}"
  }
}

For multiple devices (using tokens), the result will be an array:

{
  "success": true,
  "result": [
    {
      "name": "projects/{project-id}/messages/{message-id-1}"
    },
    {
      "name": "projects/{project-id}/messages/{message-id-2}"
    }
  ]
}

Error Responses

401 Unauthorized

{
  "success": false,
  "message": "Authentication required"
}

403 Forbidden

{
  "success": false,
  "message": "No project configuration found for this user"
}

400 Bad Request

{
  "success": false,
  "message": "title is required"
}

500 Internal Server Error

{
  "success": false,
  "message": "FCM send error: 404 Requested entity was not found"
}

03 May 2026