Update Ad

Update an Ad

PUT /ads/facebook/ads

cURL

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

200: Success

{
    "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.

Header Parameters

Body Parameters

adId · string · required

The boosted ad ID to update.

status · string · required

The status of the ad. Values: active, paused, deleted, or archived.

cURL

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

200: Success

{
    "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'."
}