Nonprofits using Volunteers for Salesforce (V4S) often find that the volunteer jobs calendar and jobs listing that come with the package pose some styling challenges that make it hard to display this information in a way that matches the organization’s website look and feel. In addition, there is a need to ensure these widgets are responsive and look good on mobile devices.

DaizyLogik has developed a suite of data services that retrieve data from and can post data to Volunteers for Salesforce to facilitate meeting these requirements. Organizations can work with their web developers to use these web services and populate the volunteer job calendar or list of volunteer jobs on their website and to build custom forms that allow volunteers to sign up for volunteer shifts.

What it means for end users?

If you’re interested in using this service please contact DaizyLogik and we’ll set you up with a URL that points to your SF CRM. You will need to provide us with the login information for a Salesforce user account: user name, password and security token (preferably the password should never expire for this user).

It’s that simple. Then you’ll want to work with your web developer to display the data on your website.

What it means for web developers?

Do your clients want to expose Volunteers for Salesforce data on their website?  Are they asking for a responsive Volunteer Jobs calendar and Sign Up form that is styled to match their website’s look and feel?

DaizyLogik Hosted REST Data Services provide an easy way to access Volunteers for Salesforce data without having to write any code in Salesforce. We did all the hard work to authenticate and extract the needed Volunteers for Salesforce data, all you need to do is access a unique URL and read the JSON output which you can feed into web widgets, plugins, or PHP code.

V4S Data services Details and API Reference

JobListing

The JobListing web service will retrieve the job listing data with volunteers shifts for a specific timeframe.

The following Volunteer Shift fields are retrieved:

  • Id
  • Start Date Time
  • Number of Volunteers Still Needed
  • Duration

The following Volunteer Job fields are retrieved:

  • Name
  • Inactive

Only Volunteer Jobs with Display on Website equals true are being retrieved.

If you have custom fields that you have added to Volunteer Shift or Volunteer Job we can easily retrieve those if you tell us the field names.

Supported HTTPS method: GET

Required Parameters:

  • clientId – this is an id provided by DaizyLogik for each client
  • year – 4 digit number
  • month – number

Example: Getting the job listing for November of 2017

https://daizylogik.herokuapp.com/jobListing?clientid=59xa8dHdNJ3v&year=2017&month=11

JobDetail

Once you select a job, we retrieve the details about that job, so you can display those details them on your website page.

The following Volunteer Shift fields are retrieved:

  • Id
  • Start Date Time
  • Duration

The following Volunteer Job fields are retrieved:

  • Id
  • Name
  • Description
  • Location Information

Supported HTTPS method: GET

Required Parameters:

  • clientId – this is an id provided by DaizyLogik for each client
  • shiftId

Example: Getting the job detail for a specific job.

https://daizylogik.herokuapp.com/jobDetail?clientid=59xa8dHdNJ3v&shiftid=a0m1I000001VbNfQAK

Signup

In Volunteers for Salesforce, a volunteer can sign up for a shift from the Sign Up form. Our signup web service allows for volunteer sign up information to be sent to Salesforce and be stored in the Volunteers for Salesforce objects.

Supported HTTPS method: POST

Required Fields:

  • clientId – this is an id provided by DaizyLogik for each client
  • shiftId
  • jobId
  • FirstName
  • LastName
  • Email
  • Status
  • Start Date

Supported Fields:

  • Hours Worked
  • Phone
  • Home Phone
  • Mailing State
  • Mailing Postal Code
  • Number of Volunteers
  • Volunteer Organization

Example:

curl -X POST -H "Content-Type: application/json" -d '{"clientId":"59xa8dHdNJ3v","Contact.FirstName":"Jimmy","Contact.LastName":"Page","Contact.Email":"jp@gmail.com", "Contact.Phone":"123-456-7777","Contact.HomePhone":"444-555-6666","Contact.GW_Volunteers__Volunteer_Organization__c":"Daizy Logik","Contact.MailingState":"WA","Contact.MailingPostalCode":"98009","GW_Volunteers__Volunteer_Hours__c.GW_Volunteers__Number_of_Volunteers__c":"1", "GW_Volunteers__Volunteer_Hours__c.GW_Volunteers__Volunteer_Shift__c":"a0m1I000001WWAwQAO", "GW_Volunteers__Volunteer_Hours__c.GW_Volunteers__Volunteer_Job__c": "a0k1I00000BbwjRQAR", "GW_Volunteers__Volunteer_Hours__c.GW_Volunteers__Status__c":"Web Sign Up", "GW_Volunteers__Volunteer_Hours__c.GW_Volunteers__Start_Date__c":"2017-11-14", "GW_Volunteers__Volunteer_Hours__c.GW_Volunteers__Hours_Worked__c":"2"}' https://daizylogik.herokuapp.com/signup

On Tuesday, June 26, 2018, we hosted a webinar to demonstrate a new Volunteers for Salesforce Calendar integrated in a website with a WordPress plugin and Hosted Web Services.  

In this short demo, we share how nonprofits using Volunteers for Salesforce (V4S) can use web services to display a volunteer jobs calendar and jobs listing in a way that matches your organization’s website look and feel, all while ensuring widgets are responsive and look good on your volunteers’ mobile devices.

Yes, I’d like to see this demo!