Boost recurring donations this giving season with the new upsell prompt!Learn How >>

Why do I see an "Authorization Required" page when I press the Preview button on a campaign?

updated

If your Campaign's Preview button hasn't been setup up just right, you might sometimes see a webpage that says something like:  "Authorization Required" with the Force.com logo on it.  Here's a few things you can try to make sure the proper preview of your email appears instead.

  1. Ensure you're using at least Soapbox Mailer v1.14 or greater.

  2. Ensure that all of the object settings for the Soapbox Mailer Email Tracking Profile listed in the Getting Started with Soapbox Mailer guide are properly set.  You can get to the object settings by going to Setup > Develop > Sites > Soapbox Mailer Email Tracking > Public Access Settings.

  3. Ensure that the Email Template you're using for the Campaign has the {!Campaign.EmailBodyHTML} included in it.

  4. Ensure that your HTML Body has content in it.

  5. Ensure that your Text Body has content in it.

  6. Ensure that your Preview button URL is correct by going to Setup > App Setup > Customize > Campaigns > Buttons and Links > Custom Buttons and Links > Preview > Edit > the big text area at the bottom of the page should have:  <<Your New Site URL>>/apex/sbm__sbx_emailviewbodyhtml?id={!Campaign.Id}

    NOTE: Replace “<<Your New Site URL>> with your Site URL, INCLUDING the "/track" at the end of it.

    So, if your Site URL is "http://picnet.force.com/track", your URL in this big text area would be:

    http://picnet.force.com/track/apex/sbm__sbx_emailviewbodyhtml?id={!Campaign.Id}

    Very often, people just forget to include the "/track" before the "/apex..." or simply have made a mistype in the URL itself.

  7. Ensure that your Site's Name is "sbx_EmailTracking" by going to Setup > App Setup > Develop > Site > click on Soapbox Mailer Email Tracking link, and confirm that the Site Name value is "sbx_EmailTracking".

  8. Check your Campaign object's sharing rules

    In order to show you the preview, your Salesforce user and Soapbox Mailer app needs to have access reading the Campaign object.  Here's what you can do to make sure that's happening properly.

    1. Go to Setup > Administration Setup > Security Controls > Sharing Settings

    2. Under the Organization-Wide Defaults section, look for the Campaign object permissions.  If the Campaign object has its Default Access listed as "Private", it means that by default, your Campaign object will not be accessible by Soapbox Mailer.  Continue to Step 3.  If it says anything else, you can skip the rest of this troubleshooting.

    3. In the dropdown list next to "Managing sharing settings for:", choose the "Campaigns" object.

    4. On the Campaigns sharing settings page, under the "Campaign Sharing Rules" section, click the New button.

    5. On the Campaign Sharing Rule page, enter the following information:

      Label:  Soapbox Mailer Campaign Sharing
      Rule Name:  Soapbox_Mailer_Campaign_Sharing
      Campaign: owned by members of:  All Internal Users
      Share with:  Group: Soapbox Mailer
      Campaign Access:  Read/Edit

    6. Click the Save button

    7. Go back to your Soapbox Mailer Campaign record, and click the Preview button to see if this process allowed you to view a preview of your email.

  9. Check your Email Template object's sharing rules

    In order to show you the preview, your Salesforce user and Soapbox Mailer app needs to have access reading the Email Template object.  Here's what you can do to make sure that's happening properly.

    1. Go to Setup > Administration Setup > Security Controls > Sharing Settings

    2. Under the Organization-Wide Defaults section, look for the Email Template object permissions.  If the Email Template object has its Default External Access listed as "Private", it means that by default, your Email Template object will not be accessible by Soapbox Mailer.  Continue to Step 3.  If it says anything else, you can skip the rest of this troubleshooting.

    3. In the dropdown list next to "Managing sharing settings for:", choose the "Email Template" object.

    4. On the Email Template sharing settings page, under the "Email Template Sharing Rules" section, click the New button.

    5. On the Email Template Sharing Rule page, enter the following information:

      Label:  Soapbox Mailer Email Template Sharing
      Rule Name:  Soapbox_Mailer_Email_Template_Sharing
      Rule Type:  Based on record owner
      Email Template: owned by members of:  Public Groups - All Internal Users
      Share with:  Public Groups - Soapbox Mailer
      Email Template Access:  Read
    6. Click the Save button
    7. Go back to your Soapbox Mailer Campaign record, and click the Preview button to see if this process allowed you to view a preview of your email.
  10. Ensure the sbx_EmailViewBodyHTML VisualForce page is accessible to the Soapbox Mailer Site user.

    In order to show you the preview, your Salesforce user and Soapbox Mailer app needs to have access reading the Campaign object.  Here's what you can do to make sure that's happening properly.

    1. Go to Setup > Develop > Sites > Soapbox Mailer Email Tracking
    2. On the Soapbox Mailer Email Tracking Site page, go to the "Site Visualforce Pages" section and click the Edit button
    3. Check to see if sbm.sbx_EmailViewBodyHTML is in the "Available Visualforce Pages" column. If it is, move it to the "Available Visualforce Pages" column, and then click the Save button.
Have more questions? Submit a request
Article is closed for comments.