Create a new deal

Prod Env

https://useme.com

POST

/api/2.0/deal/

Creates a new deal with the provided details.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "partner_id": "unique-ID-of-deal",
    "email_freelancer": "freelancer@example.com",
    "title": "Website redesign",
    "description": "Project scope and deliverables",
    "subcategory_id": 75,
    "amount": "1500.00",
    "currency": "PLN",
    "copyright_transfer": "license",
    "freelancer_language": "pl"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://useme.com/api/2.0/deal/' \
--header 'Authorization: Token <here-paste-your-token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partner_id": "unique-ID-of-deal",
    "email_freelancer": "freelancer@example.com",
    "title": "Website redesign",
    "description": "Project scope and deliverables",
    "subcategory_id": 75,
    "amount": "1500.00",
    "currency": "PLN",
    "copyright_transfer": "license",
    "freelancer_language": "pl"
}'

Responses

🟢201

application/json

Returns the payment token and initial deal status.

Bodyapplication/json

Example

{
    "data": {
        "payment_token": "string",
        "freelancer_status": "new",
        "status": "created"
    }
}

🟠400

🟠409

Modified at 2026-07-27 12:46:37

List category tree

Retrieve deal details