# Subscribers Upload API
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 Postman API call (please replace the access_token with your own valid access token)
**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)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.jobfront.io/job-boards/subscribers-upload-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.