# BidMachine Placement Management API

**Canonical:** https://apis.io/apis/bidmachine-io/bidmachine-placement-management-api/  
**Provider:** BidMachine — https://apis.io/providers/bidmachine-io/  
**Base URL:** https://api-eu.bidmachine.io/api/v1  
**Documentation:** https://developers.bidmachine.io/api/bidmachine-placement-management-api

BidMachine Placement Management API is one of 3 APIs that [BidMachine](https://apis.io/providers/bidmachine-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Advertising, Ad Exchange, App Monetization, and Placements. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Lets publishers create, list, update and delete placements on the ad sources (apps) they own programmatically, without the dashboard. Authenticate with HTTP Basic (dashboard login and password) at POST /auth to obtain a short-lived bearer token; all placement operations are scoped to sources owned by the authenticated publisher (403 otherwise). Placement ids are generated server-side from name and bundle.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/auth` | Get Access Token |
| GET | `/publisher/sources/{sourceId}/placements` | List Placements |
| POST | `/publisher/sources/{sourceId}/placements` | Create Placement |
| PUT | `/publisher/sources/{sourceId}/placements` | Update Placement |
| DELETE | `/publisher/sources/{sourceId}/placements/{id}` | Delete Placement |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/openapi/bidmachine-io-placement-management-openapi.yml
- **Documentation** — https://developers.bidmachine.io/api/bidmachine-placement-management-api
- **APIReference** — https://developers.bidmachine.io/api/bidmachine-placement-management-api
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/authentication/bidmachine-io-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/conventions/bidmachine-io-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/errors/bidmachine-io-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/data-model/bidmachine-io-data-model.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/overlays/bidmachine-io-placement-management-overlay.yaml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/skills/bidmachine-io-manage-placements.md
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/bidmachine-io/refs/heads/main/apis.yml

## Other BidMachine APIs (2)

- [BidMachine Reporting API](https://apis.io/apis/bidmachine-io/bidmachine-reporting-api/)
- [BidMachine OpenRTB Auction API](https://apis.io/apis/bidmachine-io/bidmachine-openrtb-auction-api/)

## Tags

Advertising, Ad Exchange, App Monetization, Placements

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bidmachine-io/bidmachine-placement-management-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bidmachine-io/.