Taleo ATS API Docs & Webhook Guide
Technical integration specifications, authentication methods, REST endpoints, and webhook triggers for engineering teams building recruiting integrations with Taleo.
- Public REST API
- Yes — Publicly accessible endpoints
- Webhook Support
- No webhooks (Polling required)
- Authentication Methods
- OAuth 2.0, Basic Auth
- Official Documentation
- https://docs.oracle.com/en/cloud/saas/talent-management/rest-apis
1. Architecture & Capabilities
Oracle Taleo supports REST and SOAP web services for requisition retrieval and candidate data exchange.
When pushing parsed resume data into Taleo, ensure your pipeline respects its core parser schema: single-column layout parsing, strict date parsing (strict MM/YYYY enforced), and file constraints (5MB maximum).
2. Authentication
All requests to Taleo's API require secure authentication. Configure your HTTP client with the appropriate authorization header:
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
Accept: application/json3. Code Samples & Quickstart
# Fetch candidate applications or open vacancies curl -X GET "https://api.taleo.io/v1/candidates" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Accept: application/json"
import httpx
headers = {
"Authorization": "Bearer YOUR_TOKEN",
"Accept": "application/json",
}
response = httpx.get("https://api.taleo.io/v1/candidates", headers=headers)
candidates = response.json()
print(f"Loaded {len(candidates)} candidates from Taleo")interface Candidate {
id: string;
first_name: string;
last_name: string;
email: string;
}
async function listCandidates(): Promise<Candidate[]> {
const res = await fetch("https://api.taleo.io/v1/candidates", {
headers: {
"Authorization": "Bearer YOUR_TOKEN",
"Accept": "application/json",
},
});
if (!res.ok) throw new Error(`Failed to fetch from Taleo: ${res.statusText}`);
return res.json();
}4. Webhook Event Notifications
Taleo does not natively provide outbound webhook events. Integrators must poll REST endpoints periodically (recommended interval: every 15 minutes) to synchronize candidate state.
Diagnose Candidate Resumes for Taleo
Test candidate PDFs directly against Taleo's parser specifications and geometry rules.