TenStreet

Supergood | TenStreet Hiring API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | TenStreet Hiring API

Programmatically access TenStreet Hiring driver application data, job postings, recruiting pipelines, and compliance workflows with a stable REST API. Supergood builds and operates production-grade, unofficial TenStreet integrations so your team can automate recruiting, screening, and onboarding without heavy custom engineering.

Plain English: TenStreet Hiring is recruiting and onboarding software built for trucking and logistics fleets to attract drivers, process applications (IntelliApp), communicate via Driver Pulse, run background checks (MVR, PSP, CDLIS), handle FMCSA Clearinghouse queries and consents, schedule orientation, and move candidates through hiring pipelines. An unofficial API lets you pull applicant lists, profiles, jobs, applications, statuses, consents, background check events, orientation sessions, and documents—and push new job postings, status updates, orientation schedules, messages, and offers back into TenStreet.

For a tech company integrating with TenStreet, this means you can ingest real-time applicant and job data to power recruiting dashboards, sync pipeline stages to your HRIS/ERP, automate screening requests and consent management, trigger orientation invites, attach documents, and keep stakeholder systems (ATS, HRIS, telematics, learning, analytics) in lockstep. You can also route leads from your website, allocation by terminal/region, enrich profiles with fleet data, and centralize compliance artifacts for audits.

What is TenStreet Hiring?

TenStreet Hiring (https://resources.tenstreet.com/api/) is a cloud platform for driver recruiting and compliance management used by motor carriers, private fleets, and driver recruitment teams. TenStreet centralizes driver applications (IntelliApp), lead intake, job distribution and matching (Pulse Match), recruiter workflows, background screening integrations (MVR, PSP, CDLIS), employment verification (Xchange), Clearinghouse consent/queries, onboarding documents and e-signatures, orientation scheduling, and candidate communication via the Driver Pulse app.

Core product areas include:

  • Recruiting & Lead Management (Leads, IntelliApp, Job Distribution, Pulse Match)
  • Candidate Experience (Driver Pulse Messaging, Mobile Application, Status Updates)
  • Compliance & Backgrounds (FMCSA Clearinghouse Queries/Consents, MVR, PSP, CDLIS, Employment Verification via Xchange)
  • Onboarding (E-Sign Forms, I-9/W-4, Document Collection, Policies)
  • Orientation & Training (Session Scheduling, Attendance, LMS Modules)
  • Workflow & Reporting (Pipelines, Scorecards, Tags, Recruiter Assignments)

Common data entities:

  • Companies, Users, Roles/Permissions (Recruiter, Hiring Manager, Compliance)
  • Drivers/Applicants (contact info, license/CDL details, endorsements, experience)
  • Applications & Pipeline Stages (status, sub-status, timestamps)
  • Jobs/Requisitions (position, terminal/location, requirements, pay)
  • Consents & Disclosures (Clearinghouse, background screening permissions)
  • Background Screenings (MVR, PSP, CDLIS, Clearinghouse)
  • Employment Verifications (requests/responses via Xchange)
  • Orientation Sessions & Offers (dates, location, logistics)
  • Documents & Attachments (CDL, med card, proof of employment, signed forms)
  • Messages & Notifications (Driver Pulse, email/SMS)

The TenStreet Integration Challenge

Fleets rely on TenStreet daily, but turning portal-centric workflows into API automation presents challenges:

  • Consent-heavy flows: Screening and Clearinghouse queries require candidate authorization, often via Driver Pulse, with gatekeeping states
  • Role-aware portals: Recruiters, compliance, and hiring managers see different data and actions; entitlements vary by modules and terminals
  • Fragmented objects: Applications span driver profiles, jobs, consents, screenings, and documents spread across multiple views
  • Attachment handling: Candidate documents are uploaded/downloaded via time-limited URLs and require checksum validation
  • Authentication complexity: SSO/MFA and changing session lifecycles complicate headless automation
  • Limited public APIs: Many operations are optimized for the UI or partner integrations, so stable endpoints are scarce without reverse engineering
  • Data normalization: Varying identifiers, sub-statuses, and source flags (IntelliApp, referrals, job boards, Pulse) need harmonization for analytics

How Supergood Creates TenStreet APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your TenStreet tenant.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes responses so you can integrate once and rely on consistent objects across modules
  • Aligns with customer entitlements and role-based permissions to ensure compliant access

Use Cases

Applicant & Job Data Sync

  • Mirror applicants, driver profiles, and jobs into your internal systems
  • Keep pipeline stages and timestamps current for recruiting analytics and SLA tracking
  • Normalize terminals, positions, CDL requirements, and source attribution across fleets

Pipeline Automation & Messaging

  • Move applications through screening, interview, offer, and orientation stages programmatically
  • Send Driver Pulse messages and status updates from your product
  • Trigger automated reminders for expiring med cards or missing consents

Compliance & Screening Workflows

  • Initiate and track MVR, PSP, CDLIS, and Clearinghouse queries with proper consent artifacts
  • Centralize background check results and employment verification history
  • Store and link documents to candidates with audit-ready metadata

Orientation & Onboarding

  • Schedule orientation sessions, manage capacity, and track attendance
  • Invite candidates to complete e-sign forms, I-9/W-4, and policy acknowledgments
  • Push finalized hire records into HRIS/payroll and telematics

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_tns_9241a0",
    "name": "Lead Recruiter",
    "entitlements": ["applicants", "jobs", "applications", "background_checks", "documents"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Applicants

GET /applicants: List applicants with filters and summary details.

Query parameters

  • terminalId: string
  • jobId: string
  • status: new | in_review | screening | interview_scheduled | offer_sent | orientation | hired | rejected
  • source: intelliapp | job_board | pulse | referral | recruiter_add
  • cdlClass: A | B | C | None
  • endorsements: hazmat | tanker | doubles_triples | passenger (comma-separated)
  • experienceMonths: integer (minimum)
  • hasConsent: boolean (Clearinghouse/background screening consent on file)
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "applicantId": "drv_tns_28f7c1",
      "applicationId": "app_tns_91b203",
      "firstName": "Taylor",
      "lastName": "Reed",
      "email": "[email protected]",
      "phone": "+1-402-555-0198",
      "cdl": { "class": "A", "endorsements": ["hazmat", "tanker"], "medCardExpires": "2026-07-15" },
      "experienceMonths": 26,
      "jobId": "job_tns_5b9200",
      "jobTitle": "OTR Company Driver - Midwest",
      "terminalId": "term_omaha",
      "source": "intelliapp",
      "pipeline": { "stage": "screening", "subStatus": "mvr_pending" },
      "consents": { "clearinghouse": true, "background": true },
      "updatedAt": "2026-01-20T13:45:00Z",
      "createdAt": "2026-01-18T09:12:31Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Jobs

POST /jobs: Create a job posting with position details, requirements, and visibility.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/jobs \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Regional Company Driver - Southeast",
    "description": "Home weekends. Late-model equipment. Paid orientation.",
    "terminalId": "term_atlanta",
    "location": { "city": "Atlanta", "region": "GA", "country": "US" },
    "positionType": "company_driver",
    "employmentType": "full_time",
    "requirements": {
      "minExperienceMonths": 12,
      "cdlClass": "A",
      "endorsementsRequired": ["tanker"]
    },
    "pay": {
      "type": "cpm",
      "baseCpm": 0.62,
      "bonus": { "signOn": 1500, "safetyQuarterly": 300 }
    },
    "homeTimePolicy": "Weekends",
    "visibility": { "pulseMatch": true, "jobBoards": ["indeed", "ziprecruiter"], "internal": true },
    "applicationMethod": "intelliapp",
    "tags": ["regional", "southeast", "home_weekends"],
    "notifyRecruiters": ["u_tns_9241a0"]
  }'

Example response

{
  "jobId": "job_tns_8c1b42",
  "status": "published",
  "createdAt": "2026-01-21T10:03:11Z"
}

Application Status

PATCH /applications/{applicationId}/status: Update an application’s pipeline stage, sub-status, and recruiter notes.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/applications/app_tns_91b203/status \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "stage": "interview_scheduled",
    "subStatus": "phone_screen_booked",
    "reasonCode": null,
    "recruiterId": "u_tns_9241a0",
    "notes": "Phone screen set for 2026-01-23 at 10:00 AM CT",
    "notifyCandidate": true
  }'

Example response

{
  "applicationId": "app_tns_91b203",
  "pipeline": {
    "stage": "interview_scheduled",
    "subStatus": "phone_screen_booked"
  },
  "updatedAt": "2026-01-21T11:20:44Z"
}

Background Checks

POST /background-checks/queries: Initiate a background screen or Clearinghouse query with consent references.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/background-checks/queries \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "mvr",
    "driverId": "drv_tns_28f7c1",
    "applicationId": "app_tns_91b203",
    "consent": {
      "hasConsent": true,
      "consentDocumentId": "doc_tns_consent_7739a"
    },
    "referenceId": "crm-req-2981"
  }'

Example response

{
  "requestId": "bgr_tns_51af80",
  "type": "mvr",
  "status": "submitted",
  "estimatedCompletionMinutes": 30,
  "requiresCandidateAction": false,
  "createdAt": "2026-01-21T11:45:12Z"
}

Get full API Specs →

Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of applicants, jobs, applications, background checks, consents, and documents
  • Security: Encrypted transport, scoped tokens, and audit logging; respects TenStreet role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., consent updates, background check completions, orientation changes)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume applicant sync and background screening initiation
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened TenStreet adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as TenStreet evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which TenStreet modules can this integration cover?

Supergood supports workflows across commonly used modules such as Recruiting & Lead Management (IntelliApp, Jobs, Applicants), Candidate Experience (Driver Pulse Messaging), Compliance & Backgrounds (MVR, PSP, CDLIS, Clearinghouse queries and consents), and Onboarding/Orientation (documents, sessions), subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you manage FMCSA Clearinghouse queries and employment verification?

Yes. We can initiate and track Clearinghouse pre-employment queries (with candidate consent) and normalize employment verification records from Xchange. We deliver updates via webhooks or polling while complying with rate and permission constraints.

Q: Can we post jobs and collect leads from our website?

Yes. We can publish jobs programmatically and capture leads/applications from your site or marketing campaigns, then push them into TenStreet with source attribution and terminal routing.

Q: Are attachments and driver documents supported?

Yes. We support downloading and uploading attachments via signed uploads, with checksum validation and time-limited URLs. Consent artifacts, licenses, med cards, and signed onboarding forms are modeled explicitly in our normalized responses.

Ready to automate your TenStreet workflows?

Supergood can have your TenStreet integration live in days with no ongoing engineering maintenance.

Get Started →

Read more