curl \
-H "Authorization: Bearer API_KEY" \
-X PUT https://api.ayrshare.com/api/ads/facebook/ads
-d '{"adId": 1234567890, "status": "active"}'
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/ads", {
method: "PUT",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({ adId: 1234567890, status: "active" })
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
r = requests.put('https://api.ayrshare.com/api/ads/facebook/ads', headers=headers, json={"adId": 1234567890, "status": "active"})
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode(["adId" => 1234567890, "status" => "active"])
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.PutAsync("https://api.ayrshare.com/api/ads/facebook/ads", new StringContent(JsonConvert.SerializeObject(new { adId = 1234567890, status = "active" }), Encoding.UTF8, "application/json"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/ads/facebook/ads", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/ads"))
.header("Authorization", "Bearer API_KEY")
.PUT(HttpRequest.BodyPublishers.ofString(Json.stringify(new { adId = 1234567890, status = "active" })))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/facebook/ads')
request = Net::HTTP::Put.new(uri)
request['Authorization'] = 'Bearer API_KEY'
request.body = JSON.generate({ adId: 1234567890, status: "active" })
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"adId": "6691084804905",
"requestedStatus": "ACTIVE"
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "Invalid status: actives. Status must be either 'active', 'paused', 'deleted', or 'archived'."
}
Facebook Ads
Update Ad
Update an Ad
PUT
/
ads
/
facebook
/
ads
curl \
-H "Authorization: Bearer API_KEY" \
-X PUT https://api.ayrshare.com/api/ads/facebook/ads
-d '{"adId": 1234567890, "status": "active"}'
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/ads", {
method: "PUT",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({ adId: 1234567890, status: "active" })
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
r = requests.put('https://api.ayrshare.com/api/ads/facebook/ads', headers=headers, json={"adId": 1234567890, "status": "active"})
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode(["adId" => 1234567890, "status" => "active"])
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.PutAsync("https://api.ayrshare.com/api/ads/facebook/ads", new StringContent(JsonConvert.SerializeObject(new { adId = 1234567890, status = "active" }), Encoding.UTF8, "application/json"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/ads/facebook/ads", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/ads"))
.header("Authorization", "Bearer API_KEY")
.PUT(HttpRequest.BodyPublishers.ofString(Json.stringify(new { adId = 1234567890, status = "active" })))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/facebook/ads')
request = Net::HTTP::Put.new(uri)
request['Authorization'] = 'Bearer API_KEY'
request.body = JSON.generate({ adId: 1234567890, status: "active" })
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"adId": "6691084804905",
"requestedStatus": "ACTIVE"
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "Invalid status: actives. Status must be either 'active', 'paused', 'deleted', or 'archived'."
}
Update the status of a boosted ad to make it active, paused, deleted, or archived.
- For a boost added to your own campaign or ad set with
attachTo, the new status applies only to what the boost created: the ad, and the ad set when the boost created it. The campaign or ad set you named inattachTokeeps its own status. The ad runs only while the campaign and ad set above it are active. See Boost into an Existing Campaign or Ad Set. - An ad that Ayrshare has no record of can be paused, deleted or archived, but not set to
active. That request returns a400. Contact support with the ad id.
Header Parameters
Body Parameters
string
required
The boosted ad ID to update.
string
required
The status of the ad. Values:
active, paused, deleted, or archived.curl \
-H "Authorization: Bearer API_KEY" \
-X PUT https://api.ayrshare.com/api/ads/facebook/ads
-d '{"adId": 1234567890, "status": "active"}'
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/ads", {
method: "PUT",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({ adId: 1234567890, status: "active" })
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
r = requests.put('https://api.ayrshare.com/api/ads/facebook/ads', headers=headers, json={"adId": 1234567890, "status": "active"})
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode(["adId" => 1234567890, "status" => "active"])
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.PutAsync("https://api.ayrshare.com/api/ads/facebook/ads", new StringContent(JsonConvert.SerializeObject(new { adId = 1234567890, status = "active" }), Encoding.UTF8, "application/json"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/ads/facebook/ads", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/ads"))
.header("Authorization", "Bearer API_KEY")
.PUT(HttpRequest.BodyPublishers.ofString(Json.stringify(new { adId = 1234567890, status = "active" })))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/facebook/ads')
request = Net::HTTP::Put.new(uri)
request['Authorization'] = 'Bearer API_KEY'
request.body = JSON.generate({ adId: 1234567890, status: "active" })
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"adId": "6691084804905",
"requestedStatus": "ACTIVE"
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "Invalid status: actives. Status must be either 'active', 'paused', 'deleted', or 'archived'."
}