Create Awareness Campaign

Developing

POST

{teamId}/meta/campaign/awareness

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

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://staging.api.adlyft.otomatika.net/api/v1/cabbdc29-3fe5-43c7-b815-084ab7c9f6fe/meta/campaign/awareness?adAccountId=act_1342045733694920' \
--header 'x-api-key: $2b$10$3gm2vjmU2FT2iHNlwu/Lg.Gwta4oya1evIS8uBXp5Zs/5Kelh0aCK' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "campaignName": "Awareness - Basic Reach",
    "status": "PAUSED",
    "budget": 10,
    "startDate": "2025-12-01",
    "endDate": "2025-12-10",
    "specialAdCategories": [
        "NONE"
    ],
    "adSetName": "Awareness Adset - Basic",
    "pageId": "784350118091291",
    "creatives": {
        "primaryText": "This is a basic awareness ad",
        "headline": "Brand Awareness",
        "callToAction": "LEARN_MORE",
        "imageUrl": "https://images.pexels.com/photos/9160637/pexels-photo-9160637.jpeg",
        "description": "Short description for awareness ad",
        "url": "https://example.com"
    },
    "targeting": {
        "ageMin": 18,
        "ageMax": 35,
        "genders": [
            0
        ],
        "geoLocations": [
            {
                "type": "country",
                "id": "US"
            }
        ]
    },
    "optimizationGoal": "REACH"
}'

Response Example

{}

Modified at 2026-01-14 09:27:35

Create Sales Campaign

Create Engagement Campaign