Create a lead campaign

POST

/meta/campaign/lead

This endpoint is used to create a campaign for leads ads. Lead generation ads are ad campaigns designed to collect contact information (like name, email, phone number) directly from users on Meta platforms without needing them to leave the app.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Created Meta lead campaign.

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.adlyfy.dev/api/v1//meta/campaign/lead?adAccountId' \
--header 'x-api-key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "campaignName": "string",
    "status": "PAUSED",
    "budget": 1,
    "budgetType": "DAILY",
    "startDate": "string",
    "endDate": "string",
    "specialAdCategories": [
        "NONE"
    ],
    "specialAdCountry": [
        "string"
    ],
    "adSetName": "string",
    "leadFormId": "string",
    "audienceId": [
        "string"
    ],
    "targeting": {
        "genders": [
            0
        ],
        "ageMin": 18,
        "ageMax": 18,
        "geoLocations": [
            {
                "type": "country",
                "id": "string"
            }
        ],
        "excludedGeoLocations": [
            {
                "type": "country",
                "id": "string"
            }
        ],
        "interests": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "behaviors": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "relationshipStatuses": [
            0
        ],
        "lifeEvents": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "industries": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "income": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "familyStatuses": {
            "id": "string",
            "name": "string"
        },
        "educationSchools": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "educationStatuses": [
            "1"
        ],
        "educationMajors": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "workEmployers": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "workPositions": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "locales": [
            0
        ]
    },
    "creatives": {
        "primaryText": "string",
        "headline": "string",
        "url": "string",
        "callToAction": "SIGN_UP",
        "imageUrl": "string",
        "videoId": "string",
        "thumbnailUrl": "string",
        "description": "string"
    },
    "pageid": "string",
    "instagramActorId": "string",
    "conversionLocation": "ON_AD"
}'

Response Example

{
    "data": {},
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200
}

Modified at 2026-04-30 10:48:06

List Meta lead forms

Create an awareness campaign