All messages sent in Notifuse are attached to contacts (= users). This way, we can keep track of which messages have been read by your users.

Every contact has its own profile, where you can store some data. The user profile data is then available in your templates as a user object (i.e: Hello {{ user.firstName }}).

Reserved fields

To improve & anticipate the future cool Notifuse features, some profile fields are reserved or have a specific format to respect if you want to use them.

All profile fields are optional, but you still have to specify the email address of your contacts if you want to email them!

The following fields are used by channels to route the messages:

    "id": "xxxxx",
    "firstName": "John",
    "lastName": "Doe",
    "timezone": "Europe/London",
    "language": "en",
    "country": "GB",
    "photoURL" :""

Importing & updating contacts

You can initially import your CSV contacts list via the user interface, but it's recommended to implement the API in your app to keep it synced.

Via the API, there are 2 ways to sync your contacts, with users.upsert and while you send a message.If your contact doesn't exist yet, it will be automatically inserted, otherwise it's updated!

Last updated