---
title: "Integrations - Microsoftads"
url: "https://docs.unified.to/integrations/microsoftads"
description: "Unified.to documentation"
---
##  Integration: Microsoft Advertising ![Microsoft Advertising](https://api.unified.to/docs/images/microsoft.svg)

[Back to integrations](/integrations)

#### Overview

Company website:

<https://ads.microsoft.com>

Integration launch date:

January 1, 2026

API Categories:

[Advertising](/ads/overview)[Authentication](/auth/overview)[Passthrough](/passthrough/overview)

API Authorization:

 OAuth2 flow

Data-regions:

 Production Sandbox

#### ADS ORGANIZATION

End-API object:

 account

Unified API Methods:

[List](/ads/organization/List%5Fall%5Forganizations)[Get](/ads/organization/Retrieve%5Fan%5Forganization)

List options:

\-none-

Readable fields:

[account\_number](/ads/organization/model)[currency](/ads/organization/model)[id](/ads/organization/model)[name](/ads/organization/model)[status](/ads/organization/model)[timezone](/ads/organization/model)

Slow fields:

[timezone](/ads/organization/model)[currency](/ads/organization/model)

Writable fields:

[\-none-](/ads/organization/model)

#### ADS CAMPAIGN

End-API object:

 campaign

Unified API Methods:

[List](/ads/campaign/List%5Fall%5Fcampaigns)[Get](/ads/campaign/Retrieve%5Fa%5Fcampaign)[Remove](/ads/campaign/Remove%5Fa%5Fcampaign)[Create](/ads/campaign/Create%5Fa%5Fcampaign)[Update](/ads/campaign/Update%5Fa%5Fcampaign)

List options:

org\_id

Readable fields:

[advertising\_channel\_type](/ads/campaign/model)[budget\_amount](/ads/campaign/model)[budget\_period](/ads/campaign/model)[end\_at](/ads/campaign/model)[id](/ads/campaign/model)[labels](/ads/campaign/model)[name](/ads/campaign/model)[organization\_id](/ads/campaign/model)[start\_at](/ads/campaign/model)[status](/ads/campaign/model)[targeting](/ads/campaign/model)

Slow fields:

[targeting](/ads/campaign/model)[labels](/ads/campaign/model)

Writable fields:

[name](/ads/campaign/model)[organization\_id](/ads/campaign/model)[advertising\_channel\_type](/ads/campaign/model)[budget\_amount](/ads/campaign/model)[budget\_period](/ads/campaign/model)[end\_at](/ads/campaign/model)[start\_at](/ads/campaign/model)[status](/ads/campaign/model)[targeting](/ads/campaign/model)

 required fields 

#### ADS GROUP

End-API object:

 adgroup

Unified API Methods:

[List](/ads/group/List%5Fall%5Fgroups)[Get](/ads/group/Retrieve%5Fa%5Fgroup)[Remove](/ads/group/Remove%5Fa%5Fgroup)[Create](/ads/group/Create%5Fa%5Fgroup)[Update](/ads/group/Update%5Fa%5Fgroup)

List options:

campaign\_idorg\_id

 required filter 

Readable fields:

[bid\_amount](/ads/group/model)[campaign\_id](/ads/group/model)[end\_at](/ads/group/model)[id](/ads/group/model)[name](/ads/group/model)[organization\_id](/ads/group/model)[start\_at](/ads/group/model)[status](/ads/group/model)[targeting](/ads/group/model)

Slow fields:

[targeting](/ads/group/model)

Writable fields:

[campaign\_id](/ads/group/model)[bid\_amount](/ads/group/model)[end\_at](/ads/group/model)[name](/ads/group/model)[start\_at](/ads/group/model)[status](/ads/group/model)[targeting](/ads/group/model)

 required fields 

#### ADS AD

End-API object:

 ad

Unified API Methods:

[List](/ads/ad/List%5Fall%5Fads)[Get](/ads/ad/Retrieve%5Fan%5Fad)[Remove](/ads/ad/Remove%5Fan%5Fad)[Create](/ads/ad/Create%5Fan%5Fad)[Update](/ads/ad/Update%5Fan%5Fad)

List options:

group\_idorg\_id

 required filter 

Readable fields:

[ad\_copy](/ads/ad/model)[ad\_type](/ads/ad/model)[campaign\_id](/ads/ad/model)[description](/ads/ad/model)[final\_url](/ads/ad/model)[group\_id](/ads/ad/model)[headline](/ads/ad/model)[id](/ads/ad/model)[organization\_id](/ads/ad/model)[path1](/ads/ad/model)[path2](/ads/ad/model)[status](/ads/ad/model)

Writable fields:

[group\_id](/ads/ad/model)[ad\_copy](/ads/ad/model)[description](/ads/ad/model)[final\_url](/ads/ad/model)[headline](/ads/ad/model)[path1](/ads/ad/model)[path2](/ads/ad/model)[status](/ads/ad/model)

 required fields 

#### ADS CREATIVE

End-API object:

 ad

Unified API Methods:

[List](/ads/creative/List%5Fall%5Fcreatives)[Get](/ads/creative/Retrieve%5Fa%5Fcreative)[Create](/ads/creative/Create%5Fa%5Fcreative)[Update](/ads/creative/Update%5Fa%5Fcreative)[Remove](/ads/creative/Remove%5Fa%5Fcreative)

List options:

group\_idorg\_id

 required filter 

Readable fields:

[body](/ads/creative/model)[campaign\_id](/ads/creative/model)[creative\_type](/ads/creative/model)[group\_id](/ads/creative/model)[hosting\_source](/ads/creative/model)[id](/ads/creative/model)[link\_url](/ads/creative/model)[name](/ads/creative/model)[organization\_id](/ads/creative/model)[path1](/ads/creative/model)[path2](/ads/creative/model)[status](/ads/creative/model)[title](/ads/creative/model)

Writable fields:

[group\_id](/ads/creative/model)[body](/ads/creative/model)[creative\_type](/ads/creative/model)[hosting\_source](/ads/creative/model)[link\_url](/ads/creative/model)[path1](/ads/creative/model)[path2](/ads/creative/model)[status](/ads/creative/model)[title](/ads/creative/model)

 required fields 

#### ADS REPORT

End-API object:

 report

Unified API Methods:

[List](/ads/report/List%5Fall%5Freports)

List options:

ad\_idcampaign\_idend\_ltgroup\_idorg\_idstart\_gte

Readable fields:

[currency](/ads/report/model)[end\_at](/ads/report/model)[id](/ads/report/model)[metrics](/ads/report/model)[organization\_id](/ads/report/model)[start\_at](/ads/report/model)

Writable fields:

[\-none-](/ads/report/model)

#### ADS TARGET

Unified API Methods:

[List](/ads/target/List%5Fall%5Ftargets)

List options:

querytypeorg\_id

 required filter 

Readable fields:

[id](/ads/target/model)[name](/ads/target/model)[type](/ads/target/model)

Writable fields:

[\-none-](/ads/target/model)

#### PASSTHROUGH

Unified API Methods:

[POST](/passthrough/overview)[GET](/passthrough/overview)[PUT](/passthrough/overview)[DELETE](/passthrough/overview)

List options:

\-none-

Readable fields:

[\-none-](/passthrough/undefined/model)

Writable fields:

[\-none-](/passthrough/undefined/model)