All Collections
Engaging with your audience
Emails, invitations and texting
Inviting people by letter: let people log in using a unique invitation code or token
Inviting people by letter: let people log in using a unique invitation code or token

Let people register with a unique invitation code or token, which you could for instance include in a letter or postcard.

Stijn Zwarts avatar
Written by Stijn Zwarts
Updated over a week ago

You can easily send out email invitations for people to join your platform. This can be done directly through the admin interface via the 'Invitations' tab.

However, in some cases you might not have email addresses of your target audience. Let's say you'd like to only invite people who live in a particular street or neighborhood to participate in a project. Or you want to allow people who are present at an offline event to register on the platform and participate in a specific project. In those cases, you can provide them with a unique invitation code.

One way you can do this is by sending them a physical invitation in the mail, including a unique invitation code. This code will expire after 30days. After this period, you can still resend them.

What is the benefit of the unique invitation code?

Most importantly, you can specify that someone signing up with a particular code is automatically added to a manual group upon registration.

Manual groups give you more fine grained control over who can view and participate in your projects and how. For instance, you can customize the mode of engagement or make some projects only visible to people in certain groups. You can also use your platform to send emails only to people who belong to a manual group.


How do you create unique invitation codes?

Unique invitation codes, which you can add to your external communications, can be generated directly from your platform.

  1. Create a Manual Group for your target audience. You can do this in the "Users" tab of the Admin interface.

  2. To generate the unique invitation codes, use the template available when you press "invite users" at the bottom of the groups list on the "user" tab.

  3. Fill out the template by entering the exact name of the Manual Group (from Step 1) into the column labeled "groups." Create one row per invitation that you'd like to generate. In the example below, there are six rows with a Manual Group name specified, so this would generate six invitation codes.

    Caution: you cannot invite more than 1000 people at once to the platform!

    If you would include invitee's e-mail addresses, make sure to remove any spaces after the email address (find-replace of ' '). Check that all email addresses and other fields are valid or empty if they don't have a value. Also, make sure there aren't any existing registered users in your invite list.

  4. Once you've filled out the template, upload it into the platform, in the same place as Step 2.

  5. To make sure the people who accept their invite are added to a specific group or receive certain rights on the platform, configure the invitations by filling in the different options under part 3 and click on send out invitations.

  6. Finally, go to the "All invitations" sub-tab and export the invitation list. This will download a new Excel spreadsheet that has all of the invitation codes (in the column named "token"). You can use mail merge or another tool to add the invitation codes to your communication.

  7. How will people be prompted to enter the code? In your letter or communication material, be sure to ask people to register via the web link (URL) that has been set up for invitations. This URL is your domain followed by /invite (e.g., participate.mycity.com/invite). People using this link will automatically be asked to input their invitation code upon registering.

Don't forget this step! If someone registers via your regular platform URL, they will not be asked to enter their invitation code in the first registration step. If someone registers the normal way, their email address will not be linked to the invite so the rules set in the invite won't apply.

Important note about users already registered using an invitation code: Users already registered will have to login without the code (as the code will trigger a new registration). Once logged in they will need to edit information in their account to match the conditions of access to the project (eg: street name), otherwise they will not be able to access the project. Make sure this is well communicated in your letter or communication material.


Any further questions or in need of support? Get in touch with us via the chat bubble on your platform. 💬

Did this answer your question?