# Offer Create API ``` POST https://api.offer18.com/api/m/offers ``` :link: [**Click to Test Offer Create API**](https://offer18.readme.io/reference/offers-api) ### Common Parameters | **Query** | **Type** | **Description** | | ---------- | -------- | ------------------ | | mid | Integer | Network Account ID | | api-key | String | Network API Key | | secret-key | String | Network Secret Key | **Action**


Query	Type	Description
action	String	Allowed Values: create / update / delete
offer_id	Integer	Required in Offer Update and Delete

*** ### **Fields**


Body	Type	Description
offer_name	String	Name of the Campaign
advertiser_id	Integer	Advertiser ID
offer_url	URL	Campaign's URL
external_offer_id	String	External Campaign id (if any)
app_id	String	App id (if any)
logo	URL	URL of the Campaign's logo
category	String	Category of the Campaign
preview_url	URL	Preview URL of the Campaign
currency	String	Currency of the Offer 🔗 View Currencies
price_advertiser	Decimal	Price given by Advertiser for Campaign
price_affiliate	Decimal	Price given to Affiliate for Campaign
model_advertiser	String	Advertiser Model of Campaign 🔗 View Models
model_affiliate	String	Advertiser Model of Campaign 🔗 View Models
hide_affiliate_payout	Integer	Allowed values 1: To hide Affiliate Payout
start_datetime	Timestamp UTC	Start date / time (YYYY-MM-DD HH:MM:SS)
end_datetime	Timestamp UTC	End date / time (YYYY-MM-DD HH:MM:SS )
visibility	String	Allowed values: public, permission, private
status	String	Allowed values: approve, pending
deep_links	Integer	Allowed values 1: To enable deeplinks in Offers
offer_terms	String	Terms of the Campaign
offer_kpi	String	KPI terms of the Campaign
private_note	String	Private Notes in Campaign
imps_url	URL	Impression URL
landing_page_name_1	String	Name of the first landing page
landing_page_url_1	URL	URL of the first landing page for the Campaign
landing_page_name_2	String	Name of the second landing page
landing_page_url_2	URL	URL of the second landing page for the Campaign
creatives	URL	URL of the Creatives for the Campaign
fallback	boolean	Allowed values: 1: To enable Fallback
fallback_offer_id	Integer	Fallback's Offer ID
fallback_url	URL	URL of the Fallback
fraud_conv_speed	Integer	Time in seconds
proxy_block	Integer	Allowed values: 1: To block proxies
blank_ref_block	Integer	Allowed values: 1: To block blank Reference
hide_referral	Integer	Allowed values: 1: To hide referral
assign_affiliates	Integer	Assign Affiliates to this Campaign (Comma-separated values)
capping_rule_id	String	In case user wants to Update existing capping rule
capping[0][capping_rule_name]	String	Capping Rule Name
capping[0][capping_rule_type]	String	Type of capping rule 1. advertiser_capping 2. affiliate_capping
capping[0][capping_timezone]	Timestamp	Capping Timezone
capping[0][capping_events]	String	Capping events
capping[0][capping_type]	String	Type of capping 1. gross_conversions 2. approved_conversions 3. gross_revenue 4. approved_revenue 5. gross_payout 6. approved_payout 7. gross_clicks 8. approved_clicks
capping[0][capping_period]	String	Capping period 1. daily 2. weekly 3. monthly 4. hourly
capping[0][capping_value]	Integer	Capping Value
capping[0][overcap_action]	String	Overcap Action 1. stop 2. fallback 3. fallback_conversion_accept 4. conversion_accept 5. conversion_reject 6. conversion_pending
capping[0][capping_notification_email]	Stirng	Capping Notification Email
capping[0][capping_affiliate_visibility]	Integer	1: To Show Capping Rule to affiliate
capping[0][capping_affiliate_id]	Stirng	Affiliate ID's (Comma seperated)
target_country	String	Allow specific Country 🔗 View Countries
block_country	String	Block specific Country 🔗 View Countries
target_os	String	Allow specific Operating system 🔗 View OS
block_os	String	Block specific Operating system 🔗 View OS
target_device	String	Allow specific Devices 🔗 View Devices
block_device	String	Block specific Devices 🔗 View Devices
target_browser	String	Allow specific Browser 🔗 View Browsers
block_browser	String	Block specific Browser 🔗 View Browsers
target_isp	String	Allow specific ISP
block_isp	String	Block specific ISP
events[0][event_name]	String	Name of the event
events[0][event_token]	String	Token for the event
capping_conversion_period	String	Depreciated
capping_budget	Integer	Depreciated
capping_conversion	Integer	Depreciated
capping_budget_period	String	Depreciated

**Capping Rules (Instructions)** {% hint style="info" %} 1. If you want to set multiple capping rules, you can do it by assigning rules to different numbers\ **Example 1:** \ capping\[**1**]\[capping\_rule\_name] \ capping\[**1**]\[capping\_rule\_type]\ **Example 2:**\ capping\[**2**]\[capping\_rule\_name] \ capping\[**2**]\[capping\_rule\_type] 2. If you want to update existing capping rule, you must post **capping\_rule\_id** in API Request along with new data to **0**(Zero) number\ **Example:**\ capping\[**0**]\[capping\_rule\_name] \ capping\[**0**]\[capping\_rule\_type] {% endhint %} **Events (Instructions)** {% hint style="info" %} 1. If you want to create multiple events, you can do it by assigning events to different numbers\ **Example 1:** \ events\[1]\[event\_name] \ events\[1]\[event\_token]\ **Example 2:**\ events\[2]\[event\_name] \ events\[2]\[event\_token] {% endhint %} *** ### Example API Request **Offer Create**

**API Response** ``` { "status": "200", "response": "offer_created_successfully", "offer_id": 000012 } ``` **Offer Update**

**API Response** ``` { "status": "200", "response": "offer_updated_successfully", "offer_id": "000001" } ``` *** {% hint style="info" %} **For secure interactions, always call the API from the server-side.** {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://knowledgebase.offer18.com/network/network-api/offer-create-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.