Mapp Marketing Cloud

Mapp Marketing Cloud Profile Attributes API

The Profile Attributes API from Mapp Marketing Cloud — 14 operation(s) for profile attributes.

GitHub OpenAPI
Business capability
Customer Data Management BC-420.10

Operations 14

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /profileAttributes/archive Archive profile attributes · Archive profile attributes #
Ask an LLM
“Can I retire profile attributes we no longer use without deleting them?”
“What happens to a profile attribute once it's archived?”
Tell an agent
Archive the profile attributes I list here.
Move our unused loyalty profile attributes into the archive.
POST /profileAttributes/create Create a profile attribute · Create a profile attribute #
Ask an LLM
“How do I add a new custom field to every contact's profile?”
“Can I define a new date-type profile attribute for birthdays?”
Tell an agent
Create a new profile attribute called FavoriteStore of type string.
Add a custom profile attribute for customer tier.
GET /profileAttributes/get Get one profile attribute definition · Get a single profile attribute by ID #
Ask an LLM
“What data type and settings does a specific profile attribute have?”
“Can I look up a single profile attribute definition by its ID?”
Tell an agent
Show the definition of profile attribute {attributeId}.
Get the settings for profile attribute ID {attributeId}.
GET /profileAttributes/getAvailableChannels List channels a profile attribute can be assigned to · Get available channels for attribute assignment #
Ask an LLM
“Which channels can I assign a profile attribute to?”
“What channel options exist when scoping a profile attribute?”
Tell an agent
List the channels available for profile attribute assignment.
Show me which channels I can attach attributes to.
GET /profileAttributes/getMarked Get recipient statistics attribute settings · Get recipient statistic settings #
Ask an LLM
“Which profile attributes are currently flagged for recipient statistics?”
“What are our recipient statistic settings right now?”
Tell an agent
Show which profile attributes are marked for recipient statistics.
Get the current recipient statistic settings.
GET /profileAttributes/getCapacity Check remaining profile attribute capacity · Get remaining profile attribute capacity per data type #
Ask an LLM
“How many more profile attributes of each data type can I still create?”
“Are we running out of room for new numeric profile attributes?”
Tell an agent
Show the remaining profile attribute capacity per data type.
Check how many more string attributes we can add.
GET /profileAttributes/getTechnical List technical system attributes · Get technical (system) attributes #
Ask an LLM
“What built-in system attributes does every profile have?”
“Which technical attributes are managed by the platform rather than by us?”
Tell an agent
List the technical system attributes.
Show me the built-in platform attributes on profiles.
GET /profileAttributes/list List custom profile attributes · List profile attributes #
Ask an LLM
“Which custom profile attributes have we defined?”
“Can I include archived attributes when listing profile attributes?”
Tell an agent
List all our profile attributes.
List profile attributes with archived set to {archived} and enum values included: {withEnums}.
POST /profileAttributes/markForStats Include a profile attribute in recipient statistics · Mark a profile attribute for recipient statistics #
Ask an LLM
“How do I get a profile attribute to show up in recipient statistics?”
“Can I break recipient stats down by a custom attribute like region?”
Tell an agent
Mark attribute {attributeName} for recipient statistics.
Start tracking {attributeName} in recipient stats.
POST /profileAttributes/restore Restore archived profile attributes · Restore archived profile attributes #
Ask an LLM
“Can I bring back a profile attribute I archived by mistake?”
“Is archiving a profile attribute reversible?”
Tell an agent
Restore these archived profile attributes.
Unarchive the profile attributes I list.
GET /profileAttributes/export Export profile attributes to CSV · Trigger async CSV export of profile attributes #
Ask an LLM
“Can I download all profile attribute definitions as a CSV?”
“Does exporting profile attributes run in the background?”
Tell an agent
Start a CSV export of our profile attribute definitions.
Export the profile attribute list to CSV.
POST /profileAttributes/unmarkForStats Remove a profile attribute from recipient statistics · Unmark a profile attribute from recipient statistics #
Ask an LLM
“How do I stop a profile attribute from appearing in recipient statistics?”
“Can I drop an attribute from recipient stats without archiving it?”
Tell an agent
Unmark attribute {attributeName} from recipient statistics.
Stop tracking {attributeName} in recipient stats.
PUT /profileAttributes/update Update a profile attribute definition · Update a profile attribute #
Ask an LLM
“Can I rename or change the description of an existing profile attribute?”
“What settings of a profile attribute can be edited after creation?”
Tell an agent
Update profile attribute {attributeId} with the new settings.
Change the description of profile attribute {attributeId}.
GET /profileAttributes/validateName Check a profile attribute name is available · Validate profile attribute name uniqueness #
Ask an LLM
“Is a profile attribute name already taken?”
“Can I check a new attribute name is unique before creating it?”
Tell an agent
Check whether profile attribute name {name} is unique.
Validate {name} as a new profile attribute name.

Documentation

📖
Documentation
https://docs.mapp.com/apidocs/engage-api
📖
GettingStarted
https://docs.mapp.com/apidocs/getting-started-with-engage-api
📖
APIReference
https://docs.mapp.com/apidocs/engage-api-calls
📖
Documentation
https://docs.mapp.com/apidocs/analytics-api
📖
APIReference
https://docs.mapp.com/apidocs/analysis-analytics-api
📖
Documentation
https://docs.mapp.com/apidocs/product-catalog-api
📖
APIReference
https://docs.mapp.com/apidocs/product-catalog-api-api-reference
📖
Authentication
https://docs.mapp.com/apidocs/product-catalog-api-authentification
📖
Documentation
https://docs.mapp.com/apidocs/mapp-fashion-api-documentation

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mapp/refs/heads/main/openapi/mapp-profile-attributes-api-openapi.yml

Other Resources

🔗
Postman
https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/Analytics%20API.postman_collection.json
🔗
ChangeLog
https://docs.mapp.com/apidocs/changelog-mapp-fashion-api

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mapp:mapp-profile-attributes-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mapp-profile-attributes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mapp Engage public Profile Attributes API
  version: '1'
  description: 'Mapp Engage REST API (REST 2.0, incremental version v19). Assembled verbatim from the per-operation OpenAPI fragments Mapp publishes on each endpoint page of https://docs.mapp.com/apidocs/. The base URL is tenant-specific: take your Mapp Engage login host and append /api/rest/v19.'
  contact:
    name: Mapp Technical Support
    url: https://mapp.com/tech-support/
servers:
- url: /api/rest/v19
security:
- basicAuth: []
tags:
- name: Profile Attributes
paths:
  /profileAttributes/archive:
    post:
      tags:
      - Profile Attributes
      summary: Archive profile attributes
      description: ''
      operationId: archive_2
      responses:
        default:
          description: successful operation
  /profileAttributes/create:
    post:
      tags:
      - Profile Attributes
      summary: Create a profile attribute
      description: ''
      operationId: create_4
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduledOperationResult'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProfileAttributeData'
  /profileAttributes/get:
    get:
      tags:
      - Profile Attributes
      summary: Get a single profile attribute by ID
      description: ''
      operationId: get_5
      parameters:
      - name: attributeId
        in: query
        required: false
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileAttribute'
        '404':
          description: Not found
  /profileAttributes/getAvailableChannels:
    get:
      tags:
      - Profile Attributes
      summary: Get available channels for attribute assignment
      description: ''
      operationId: getAvailableChannels
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ChannelInfo'
  /profileAttributes/getMarked:
    get:
      tags:
      - Profile Attributes
      summary: Get recipient statistic settings
      description: ''
      operationId: getMarked
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipientStatisticResult'
  /profileAttributes/getCapacity:
    get:
      tags:
      - Profile Attributes
      summary: Get remaining profile attribute capacity per data type
      description: ''
      operationId: getCapacity
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttributeCapacity'
  /profileAttributes/getTechnical:
    get:
      tags:
      - Profile Attributes
      summary: Get technical (system) attributes
      description: ''
      operationId: getTechnical
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProfileAttribute'
  /profileAttributes/list:
    get:
      tags:
      - Profile Attributes
      summary: List profile attributes
      description: ''
      operationId: list_4
      parameters:
      - name: archived
        in: query
        required: false
        schema:
          type: boolean
      - name: withEnums
        in: query
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProfileAttribute'
  /profileAttributes/markForStats:
    post:
      tags:
      - Profile Attributes
      summary: Mark a profile attribute for recipient statistics
      description: ''
      operationId: markForStats
      parameters:
      - name: attributeName
        in: query
        required: false
        schema:
          type: string
      responses:
        default:
          description: successful operation
  /profileAttributes/restore:
    post:
      tags:
      - Profile Attributes
      summary: Restore archived profile attributes
      description: ''
      operationId: restore
      responses:
        default:
          description: successful operation
  /profileAttributes/export:
    get:
      tags:
      - Profile Attributes
      summary: Trigger async CSV export of profile attributes
      description: ''
      operationId: export_3
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExportJobResult'
  /profileAttributes/unmarkForStats:
    post:
      tags:
      - Profile Attributes
      summary: Unmark a profile attribute from recipient statistics
      description: ''
      operationId: unmarkForStats
      parameters:
      - name: attributeName
        in: query
        required: false
        schema:
          type: string
      responses:
        default:
          description: successful operation
  /profileAttributes/update:
    put:
      tags:
      - Profile Attributes
      summary: Update a profile attribute
      description: ''
      operationId: update_4
      parameters:
      - name: attributeId
        in: query
        required: false
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduledOperationResult'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProfileAttributeData'
  /profileAttributes/validateName:
    get:
      tags:
      - Profile Attributes
      summary: Validate profile attribute name uniqueness
      description: ''
      operationId: validateName_3
      parameters:
      - name: name
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: boolean
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication with a Mapp Engage system user of type API (or Hybrid).
x-apievangelist-provenance:
  method: searched
  generated: '2026-08-12'
  source: https://docs.mapp.com/apidocs/ (per-endpoint OpenAPI fragments)
  note: Union of the OpenAPI JSON fragments Mapp publishes on each endpoint page. Mapp does not serve one consolidated document at a public URL; the tenant-served Swagger lives at https://<your-engage-host>/apidoc/swagger.json and requires a tenant. Operation bodies, parameters, responses, tags, summaries and descriptions are verbatim from Mapp. The swagger/basePath/schemes/securityDefinitions envelope is added by API Evangelist from the published Getting Started guide; no operation content was authored.
  duplicate_operation_ids_suffixed: 30