List mapping presets of a template

Scope templates.read

Path parameters

idstringrequired

Returns

10 fields of the 200 answer

idstringrequired

templateIdstringrequired

namestringrequired

headersarray of stringrequired

mappingobjectrequired

createdByTypeenumrequired

USERAPI_KEY

createdByIdstringrequired

lastUsedAtdate-time or nullrequired

createdAtdate-timerequired

updatedAtdate-timerequired

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

404Not found

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

Request

curl https://api.postbuddy.nl/v1/templates/tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K/mapping-presets \
  -H "Authorization: Bearer $POSTBUDDY_API_KEY"

import { PostBuddyClient } from '@postbuddy/sdk';

const client = new PostBuddyClient({ apiKey: process.env.POSTBUDDY_API_KEY! });

const result = await client.mappingPresets.list('tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K');

import os
from postbuddy import Client

client = Client(os.environ["POSTBUDDY_API_KEY"])

result = client.mapping_presets.list("tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K")

Response

[
  {
    "id": "mp_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
    "templateId": "tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
    "name": "Welcome card",
    "headers": [
      "Example"
    ],
    "mapping": {
      "key": "first_name"
    },
    "createdByType": "USER",
    "createdById": "obj_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
    "lastUsedAt": "2026-10-16T09:14:02.000Z",
    "createdAt": "2026-10-16T09:14:02.000Z",
    "updatedAt": "2026-10-16T09:14:02.000Z"
  }
]

{
  "type": "https://docs.postbuddy.nl/errors/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "Not found",
  "requestId": "req_01J9Y2K8QF4T6W8Z0B2D4F6H8K"
}