Create a Buyer Persona

POST

/v1/buyer-personas

Create a new buyer persona in the account.

Credit Note: Creating a buyer persona does not consume credits.

INFO

Requires the buyer_personas:write OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Examples

Department and seniorityJob title keywords in one country

Senior sales decision makers

{
    "data": {
        "type": "buyer_persona",
        "attributes": {
            "name": "Sales Leaders",
            "filters": {
                "department": [
                    {
                        "search_value": "sales_department",
                        "display_value": "Sales"
                    }
                ],
                "seniority": [
                    {
                        "search_value": "top_management",
                        "display_value": "Top management"
                    }
                ]
            }
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Department and seniorityJob title keywords in one country

curl --location 'https://api.leadfeeder.com/v1/buyer-personas?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "type": "buyer_persona",
        "attributes": {
            "name": "Sales Leaders",
            "filters": {
                "department": [
                    {
                        "search_value": "sales_department",
                        "display_value": "Sales"
                    }
                ],
                "seniority": [
                    {
                        "search_value": "top_management",
                        "display_value": "Top management"
                    }
                ]
            }
        }
    }
}'

Responses

🟢201Created

application/json

Success

Bodyapplication/json

Example

{
    "data": {
        "type": "buyer_persona",
        "id": "7421",
        "attributes": {
            "name": "Sales Managers",
            "created_at": "2024-12-10T15:57:25Z",
            "filters": {
                "department": [
                    {
                        "search_value": "sales_department",
                        "display_value": "Sales",
                        "negated": false
                    }
                ],
                "job_title": [
                    {
                        "search_value": "Manager",
                        "display_value": "Manager",
                        "negated": false
                    }
                ],
                "seniority": [
                    {
                        "search_value": "top_management",
                        "display_value": "Top management",
                        "negated": false
                    },
                    {
                        "search_value": "middle_management",
                        "display_value": "Middle management",
                        "negated": false
                    }
                ],
                "location": [
                    {
                        "search_value": "US",
                        "display_value": "United States",
                        "negated": true
                    }
                ]
            }
        }
    },
    "meta": {
        "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-08-21 12:35:59

Retrieve Buyer Personas

Get Buyer Persona Details