Jobfront Help Center
  • Welcome to Jobfront
  • Job Boards
    • Getting Started
    • Sitemaps For Job Board Indexing
    • Set up Custom Sub/Domains (Email + Job board)
    • Add Google Analytics (and other analytics providers)
    • SEO Landing Pages
    • SEO Optimization - Google Index API Integration
    • Newsletter Landing Page
    • Show all tracked organizations
    • Subscriber Signup Embed Unit
    • Jobs Feed Embed Unit
    • Subscribers Upload API
    • "2-tap" Subscriptions - Auto-Populate Email Address Inputs
    • Slack Integrations
    • Terms of Service / Privacy Policy
    • Monetization - Subscriber $ Gate
    • Monetization - Sponsored jobs/newsletters
  • Job Post Data API
    • Getting Started
    • Jobs Data API
    • Signals API (GrowthFront)
    • Webhooks
    • XML Job Posts & Signals Feeds
  • Data Processing & Cleaning
  • AI Agents
    • In beta.
Powered by GitBook
On this page
  1. Job Boards

Subscribers Upload API

PreviousJobs Feed Embed UnitNext"2-tap" Subscriptions - Auto-Populate Email Address Inputs

Last updated 1 year ago

You can upload a list of email addresses to your Jobfront account

POST /api/subscribers/upload

Required Fields:
email_addresses - comma-separated email addresses
access_token - required API access key (please contact hello@jobfront.io)

Expected response:

(Success) - 200 empty dictionary
(Failure) - 400 with an error message in 'responseText' field

---

Example usage:

POST https://app.jobfront.io/api/subscribers/upload

Json data:
{
    "email_addresses":"john@email.com,jane@email.com,user@domain.com",
    "access_token":"123abc"
}

Example response (success):

{}

Example response (error):

{
    "responseText":"Error 'access_token invalid'"
}

---

Important notes:

  • Jobfront will verify that the email address is valid

  • Jobfront will verify that the email address is not already a subscriber for your account, and will never add duplicate email addresses

  • If you have multiple categories of jobs in your account (eg, "Sales" "BDR" "SDR" filterable tags), when you upload email addresses those email addresses will be signed up for all available filterable tags

  • There's a limit of 100 email addresses per api call. Please split into multiple calls if your list is greater than 100

  • If you upload multiple email addresses and one fails, the remaining email addresses will successfully upload and you will receive a success 200 {} response

Most important note:

  • Please ensure that email addresses you are adding to this list have been properly opted-in and they are expecting to be added to your email list. Otherwise you risk damaging your email sending abilities (as spam and bounced email % increases, we'll isolate email sending accounts or even opt users out automatically if they're flagging emails as spam)

Example Postman API call (please replace the access_token with your own valid access token)