Application

To begin sending notifications with 📨🚕 from your application, plugin, web service, server, script, or IoT device, you’ll first need to register an application.

This step is free and takes seconds.

Register Your Application

Log in to the console and create a new application. During registration, you’ll define:

  • Name: Displayed in notifications across supported targets.
  • Icon (optional): A small image shown with the message (where supported).
  • Format: The endpoint format, usually “Custom”, but can also be “Pushover” for migrating legacy Pushover services
  • Encryption Type (optional): Either “None” if you don’t want messages to be encrypted, or “Age” .
    Note: When activating encryption, every field you enable it for will be delivered encrypted and will require you to manually decrypt it. Encryption encrypts specific fields of the message so that your target service is unable to read them. If you need true E2EE you will need to encrypt the title/message/attachment at the source!
  • Target: The service to which the application should route messages.

Once created, you’ll be assigned an application token, a unique UUIDv4 string.

Treat this token like a secret API key. It identifies your application and authorizes it to send messages.

Use Your Webhook URL

Each application has its own dedicated webhook endpoint, based on its token. See the webhook endpoint documentation for more information, supported formats and payload examples.

Token

Your application token is a randomly generated UUIDv4 string, e.g.:

123e4567-e89b-12d3-a456-426614174000

This ensures uniqueness and is required in every webhook call.

Important Note for Redistributed Software

If you’re building a client-side library, open source package, plugin, or application that will be distributed to others:

Do not embed your application token in the public codebase.

Instead:

  • Prompt each user to register their own application.
  • Let them input their personal token during configuration.
  • Or build a small onboarding flow to register apps programmatically via the 📨🚕 API (coming soon).

This ensures:

  • Proper isolation between user environments.
  • Clear audit trails.
  • Better security for your software and your users.