Skip to main content

​
Setup

You will need a MagicBell account with a project configured. In Courier, navigate to the MagicBell Integration page, enter your API key and API secret, then click “Save.”

​
Profile Requirements

To deliver a message to in-app using MagicBell, Courier must be provided with either the email address of the recipient or an external ID.

​
Email example:

{
  "message": {
    "to": {
      "email": "recipient@example.com"
    }
  }
}

​
External ID:

{
  "message": {
    "to": {
      "magicbell": {
        "external_id": "user123"
      }
    }
  }
}

​
Overrides

Overrides can be used to change the request body that Courier uses to send a message to MagicBell. Below is an example of overriding the Category & Action URL parameters in MagicBell: 
{
  "message": {
    "template": "NOTIFICATION_TEMPLATE_ID",
    "to": {
      "email": "recipient@example.com"
    },
    "data": {},
    "providers": {
      "magicbell": {
        "override": {
          "body": {
            "category": "new_message",
            "action_url": "https://example.com/example_link"
          }
        }
      }
    }
  }
}