POST
/
external
/
upload-users
Upload Institution Members
curl --request POST \
  --url https://direct-pub-api.directgh.com/api/v1/external/upload-users \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form member_list='@example-file'
{
  "message": "file is being processed"
}

Authorizations

​
Authorization
string
header
required

HMAC signature authentication. The Authorization header must contain your public key and HMAC signature in the format: public_key:signature

Format: Authorization: public_key:signature

Example: Authorization: pub_abc123xyz:abc123def456ghi789...

The signature is generated by creating an HMAC hash of the request body (JSON stringified) using your secret key for POST/PUT requests. For GET requests, the signature is generated using the query parameters (JSON stringified) instead of the request body. Contact your account manager to obtain your public key and secret key for generating signatures.

Body

multipart/form-data
​
member_list
file
required

CSV or Excel file containing member data

Response

File uploaded successfully and queued for processing

​
message
string
Example:

"file is being processed"