Skip to main content
POST
/
beat-requests
Create a new beat request
curl --request POST \
  --url https://open.beatpass.ca/api/v1/beat-requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Need a trap beat",
  "description": "<string>",
  "budget_min": 123,
  "budget_max": 123,
  "genres": [
    "<string>"
  ]
}
'
{
  "status": "error",
  "message": "Reason for the error",
  "errors": {
    "some_data_1": "Error message for data 1",
    "some_data_2": "Error message for data 2"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
title
string
Example:

"Need a trap beat"

description
string
budget_min
number
budget_max
number
genres
string[]

Response

Beat request created

Last modified on November 29, 2025