Bulk Upload Jobs & Job Feed (XML or JSON) Documentation

Bulk Upload Job Template Documentation and FAQs

1. How do I do a bulk upload?
   We created a job upload template for you to download, and you can place your jobs in here. Once the template is all filled out, please send the file as a .CSV and submit to customerservice@locumtenens.com.
2. What do I need to include in the file?
   Take a look at our job upload guide that we created to make bulk uploading easy - Job Upload Field Rules. If you have any additional questions please contact customerservice@locumtenens.com.
3. If some of my jobs close will I need to send another file?
   We process the bulk uploads every Friday, so you can send us an updated file every week and we will remove the closed jobs and add the new ones in.
4. What specialties and titles do you accept?
   Please check the job upload template and review the ‘Specialty’ and ‘Discipline’ tabs for the specialties and titles that we accept on our job board.
5. How soon will my jobs appear?
   We process the bulk uploads Monday - Friday. We will email you a receipt of all the jobs postings once they are uploaded.
6. How much do bulk uploads cost?
   It is free to register and free to post jobs. If you want to post 50 or more jobs, we also have a free upload program, which allows you to upload your jobs quickly and easily. Contact customerservice@locumtenens.com for assistance with your job upload.
7. Do I have to fill out all the fields?
   No, the only fields required are Job Headline, Job Description, Provider Title, Specialties, Board Certification, On Call, Type of assignment, and Location.

Job Feed (XML or JSON) Documentation and Integration FAQs

Please visit this link to view our job feed (XML or JSON) documentation.

1. What account setup is required?
   Register all staff on LocumTenens.com, designate one Feed Admin, and provide their email. All contact emails in your feed must belong to registered accounts or postings will fail.
2. What format should our feed be?
   Submit XML or JSON, UTF-8 encoded. We import daily midnight–5 AM EST. Use a stable Job Reference ID (your internal job number works) to update or remove postings later.
3. What fields are required?
   Job Reference ID, Contact Email, Headline, Description, Job Duration, Locations (state), Titles, and Specialties. Optional: Bullet Points, Certifications, Salary, Expiration Date. Character limits and exact valid values are in the reference spreadsheet LocumTenens.com Feed Values 10-2026.xlsx.
4. Can we use HTML in descriptions?
   Yes, limited tags only: <em>, <strong>, <br>, <p>, <ul>, <li>. All other tags are stripped for security; script, style, and event handlers are removed.
5. What happens if there's an error?
   The Feed Admin receives an email report showing which postings failed and why (e.g., unregistered email, invalid field value, character limit exceeded). Fix the data and resubmit on the next import. Successful postings import while failed ones are skipped.
6. How do we update or remove a posting?
   Use the same Job Reference ID to update fields on the next import. Remove it from the feed entirely to unpublish. 
7. Who do we contact for support?
   Your Feed Admin monitors all import notifications and errors. They coordinate fixes with your internal team and escalate to LocumTenens.com support (customerservice@locumtenens.com) for configuration changes (frequency, notification settings, etc.).