Skip to main content

Importing Resumes via Multipart API Upload in PyjamaHR: Step-by-Step Guide, Troubleshooting, and Best Practices

Updated this week

Executive Summary

Importing resumes in bulk is a core workflow for recruiters using PyjamaHR. Whether you’re uploading dozens of CVs to a job folder or adding candidates to your talent pool, understanding the multipart API upload process ensures smooth, efficient, and error-free candidate imports. This guide covers everything you need to know to successfully import resumes, avoid common pitfalls, and resolve issues—based on real customer experiences.


Detailed Overview

What is Multipart API Resume Upload?
Multipart API upload allows you to import multiple candidate resumes (CVs) into PyjamaHR in one go, either via the web interface or programmatically. This process parses each resume, extracts candidate data, and creates candidate profiles—enabling you to quickly build your talent pipeline.

When and Why to Use It:
- Bulk import resumes received from job boards, agencies, or email
- Add candidates to specific jobs or folders (e.g., “TA”, “HRBP”, “Default”)
- Accelerate sourcing and screening using PyjamaHR’s AI Recruiter and workflow automation

Integration with Other Features:
- Imported candidates can be assigned to jobs, folders, or talent pools
- AI Recruiter can screen imported profiles (see AI Recruiter Guide)
- Candidate profiles are deduplicated using unique identifiers (e.g., email)

Business Impact:
- Saves recruiter time by eliminating manual entry
- Reduces errors and ensures consistent candidate data
- Enables faster, more effective hiring decisions


Step-by-Step Guide: Importing Resumes via Multipart API Upload

Prerequisites & Requirements

  • Resume files: Supported formats (PDF, DOC, DOCX)

  • Each resume must include a unique email address (required for candidate creation)

  • Access: Appropriate permissions to import candidates

  • Stable internet connection: Large uploads may take time

Step 1: Navigate to Resume Import

  1. Log in to your PyjamaHR account.

  2. Go to the Candidates section or the specific Job or Folder (e.g., “TA”, “HRBP”, “Default”) where you want to import resumes.

  3. Click the Import Resume button.

Screenshot callout: Show location of "Import Resume" button in Candidates/Job view.

Step 2: Select and Upload Resumes

  1. Click Upload or Drag and Drop your resume files into the upload area.
    - You can select multiple files at once.
    - Ensure each file contains a valid email address for the candidate.

Screenshot callout: Show drag-and-drop/upload area with file selection.

Step 3: Wait for Upload Completion

  1. Wait for the upload to finish.
    - The system will show a progress indicator for each file.
    - Do not click “Add to Job” or navigate away until all uploads are complete.
    - The “Add to Job” button becomes clickable only after successful upload.

Screenshot callout: Show progress bar and disabled/enabled “Add to Job” button.

Step 4: Assign Candidates (Optional)

  1. Once uploaded, assign candidates to a specific job or folder as needed.
    - Select the destination (e.g., “TA”, “HRBP”, “Default”).
    - Click Add to Job or Move to Folder.

Step 5: Confirm Import

  1. Check the Candidates list or the relevant folder/job to confirm new profiles have been created.
    - If candidates do not appear, see Troubleshooting below.


Advanced Usage & Best Practices

Power User Tips

  • Bulk Uploads: For large batches (e.g., 40+ resumes), upload in smaller groups (10-20 at a time) to reduce risk of timeouts or errors.

  • File Naming: Use clear file names (e.g., “FirstName_LastName.pdf”) for easier tracking.

  • Resume Quality: Ensure resumes are not password-protected or corrupted.

  • Unique Emails: Each resume must have a unique, valid email address—this is essential for candidate creation and deduplication.

Integration & Optimization

  • AI Recruiter: After import, use AI Recruiter to screen and shortlist candidates automatically.

  • Folders & Jobs: Organize imports by folder/job for easier tracking and workflow management.

  • API Automation: For advanced users, integrate with the PyjamaHR API for automated resume imports (contact support for API documentation).

Do’s and Don’ts

Do:
- Wait for uploads to finish before proceeding.
- Check that each resume includes an email address.
- Use supported file formats.

Don’t:
- Don’t click “Add to Job” before uploads are complete.
- Don’t upload resumes without emails—they will not be processed.
- Don’t navigate away during upload, as this may interrupt the process.


Troubleshooting & Common Issues

Common Problems & Solutions

1. “Add to Job” Button Not Clickable
- Cause: Upload is still in progress or failed.
- Solution: Wait for all uploads to complete. If still not clickable, refresh the page and retry.

2. Candidates Not Appearing After Upload
- Cause: Upload did not complete, or resumes lacked required fields (e.g., email).
- Solution: Check upload status. Ensure resumes have valid emails. Retry upload.

3. Upload Stuck or Slow
- Cause: Large file size, slow internet, or temporary server issues.
- Solution: Try uploading in smaller batches. Check your connection. If issue persists, contact support.

4. Resume Missing Required Fields
- Error: “Resume does not include an email, which is required as a unique identifier.”
- Solution: Edit the resume to include an email address and re-upload.

5. Duplicate Candidates
- Cause: Same email used in multiple resumes.
- Solution: Ensure each candidate has a unique email.

What If Scenarios

  • What if upload is stuck for hours?
    Try refreshing the page and re-uploading. If the issue persists, contact support and provide a screen recording.

  • What if I can’t see uploaded candidates in the folder/job?
    Confirm upload completion. Check other folders (e.g., “Default”). If still missing, retry upload.

  • What if I get repeated errors?
    Share a screen recording and sample resume with support for faster resolution.

Recovery Procedures

  • Failed Uploads: Retry with corrected resumes.

  • Partial Uploads: Only successfully uploaded resumes will appear; re-upload failed ones.

  • When to Contact Support:

  • Uploads consistently fail or are stuck

  • “Add to Job” remains disabled after upload

  • Candidates not appearing after multiple attempts


Comprehensive FAQ

1. Why is the “Add to Job” button not clickable after uploading resumes?
Uploads must finish before the button is enabled. Wait for all files to upload.

2. What file formats are supported for resume upload?
PDF, DOC, and DOCX.

3. Is an email address required in every resume?
Yes, each resume must include a unique email address for candidate creation.

4. What happens if two resumes have the same email?
Only one candidate profile will be created; duplicates are ignored.

5. Can I upload resumes without assigning them to a job?
Yes, you can add them to folders or the general candidate pool.

6. Why are my candidates not showing up after upload?
Possible reasons: upload incomplete, resumes missing emails, or upload failed.

7. How many resumes can I upload at once?
For best results, upload in batches of 10-20. Large uploads may take longer or fail.

8. What should I do if the upload is stuck or slow?
Try smaller batches, check your internet, and avoid navigating away during upload.

9. Can I use the API for automated resume uploads?
Yes, advanced users can use the PyjamaHR API. Contact support for documentation.

10. What information is extracted from resumes?
Key candidate details including name, email, phone, and experience.

11. Can I upload resumes to specific folders like “TA” or “HRBP”?
Yes, select the desired folder/job during the import process.

12. What if my resume is password-protected or corrupted?
Such files cannot be processed. Remove protection or use a valid file.

13. How do I troubleshoot persistent upload issues?
Share a screen recording and sample file with support for diagnosis.


Related Features & Next Steps

  • AI Recruiter: Use AI Recruiter to screen imported candidates (AI Recruiter Guide)

  • Folders & Talent Pools: Organize candidates for targeted outreach

  • Bulk Actions: Move, tag, or communicate with imported candidates

  • API Integrations: Automate resume imports with the PyjamaHR API (contact support)

Related Help Articles:
- How to Use AI Recruiter for Candidate Screening
- [Managing Candidate Folders and Talent Pools]
- [Troubleshooting Resume Upload Issues]


Summary

Importing resumes via multipart API upload in PyjamaHR is a powerful way to streamline candidate intake and accelerate hiring. By following the steps and best practices outlined above—and using the troubleshooting tips—you’ll ensure a smooth, error-free import process every time. For persistent issues, our support team is ready to help—just provide a screen recording and sample file for fastest resolution.

Did this answer your question?