Skip to main content
POST
Bulk-create screens from a CSV file

Authorizations

nonce
string
query
required

WordPress AJAX nonce (passed as form field, verified per-action)

Body

multipart/form-data
action
string
required
Allowed value: "upload_candidates_csv"
nonce
string
required

WP nonce for sagescreen_frontend_nonce

council_sage_id
integer
required

Post ID of ss_council_sage

Example:

101

csvUploader
file
required

CSV file (.csv extension required)

expiration_date
string

Invite expiration date

Example:

"2026-03-19"

send_invite_now
enum<string>

'1' to send invite emails immediately

Available options:
0,
1
Example:

"1"

email_from
string

Sender display name

Example:

"Recruiting Team"

email_from_address
string<email>
Example:

"recruiting@example.com"

email_reply_to
string<email>
Example:

"hr@example.com"

email_subject
string
Example:

"You're Invited to Interview"

email_header
string
Example:

"Welcome!"

email_body
string

HTML email body template

Example:

"<p>Hello ::FIRST_NAME::, click the link below.</p>"

Response

200 - application/json

Upload result (may include per-row errors)

success
boolean
message
string
Example:

"Processed 3 screens successfully, 1 errors"

results
object[]
created_count
integer
Example:

3

error_count
integer
Example:

1

total_count
integer
Example:

4