How to Create a Campaign

Creating a campaign in Penbox is simple and efficient. This guide will walk you through the entire process, from creating a campaign list to uploading and mapping your data, selecting flow options, and generating requests. Follow these steps to get started:

1. Create a Campaign List

  1. Log in to app.penbox.io.
  2. In the left-hand menu, click on Campaigns & Lists.
  3. In the top bar, click on Create a Campaign.
  4. Enter the name of your campaign in the modal and click Create.

Once your campaign is created, you will go through four key steps: Upload, Mapping, Option, and Creation.


2. Upload Campaign Data (Upload)

  1. In the top-right corner, click on Add Data.

  2. In the pop-up, select your file type:

    • CSV Files: Use this option if your contact data is not extracted from Brio PLW.
    • Brio Files: Use this option if your contact data is extracted from Brio PLW and needs to be imported back into Brio PLW.

👀

BRIO Campaigns

For Brio campaigns, see our specific documentation: link

  1. Upload your file(s) by clicking on Load File.
  2. Select the form template you want to use for your campaign.
  3. Click Upload Files to proceed.

3. Map Data Variables (Mapping)

After uploading your files, you'll be redirected to the Mapping step. Here, you'll allocate the correct variable types to each column in your data file to ensure your forms are properly pre-filled.

Common Variable Types in Penbox:

Variable TypeValue TypeDescription
user.given_namePlain textFirst name of the contact
user.family_namePlain textLast name of the contact
user.emailPlain textEmail address of the contact
user.phoneNumericalPhone number of the contact
data.address_streetPlain textStreet name of the contact
data.address_numberNumericalHouse number of the contact
data.address_boxPlain textHouse number addition of the contact
data.address_zipPlain textZip code of the contact
data.address_cityPlain textCity of residence
data.address_countryPlain textCountry of residence
data.date_of_birthNumericalDate of birth of the contact
data.titleStringTitle of the contact
data.marital_statusStringMarital status of the contact
data.children_hasTRUE or FALSEWhether the contact has children
data.professional_statusStringProfession of the contact
data.profession_free_textPlain textFree-text description of the contact's profession
data.sector_free_textPlain textSector of employment
data.nationalityPlain textNationality of the contact
data.ibanPlain textIBAN of the contact
data.driver_driving_license_hasTRUE or FALSEWhether the contact has a driving license
user.internal_refPlain textInternal reference of the contact
user.localnl, fr, en, duPreferred language for the contact's flow

👀

Tip

Add these variables as headers in your file to automatically map them to the correct columns. Otherwise, you can manually assign them after uploading.


4. Select Flow Options (Optional)

Once the data mapping is complete, you’ll proceed to the Options step.

  1. An overview of your flow settings will appear.
  2. Use the toggle buttons to activate or deactivate specific flow options as needed.
  3. Click Validate Options to confirm your selections.

5. Create Requests (Creation)

After validating your flow options, you’ll move to the Creation step.

  1. Click on Start Creating to generate all requests for the campaign. This process may take a few minutes, depending on the number of contacts.
  2. Once complete, your requests will be created and ready to be scheduled.

What’s Next?

Now that your campaign is created, you can plan or pause it as needed. Learn how to schedule and manage your campaigns. With these steps, you can efficiently reach your contacts and manage bulk requests with ease.