PUT /v1/ads/forms/{formId}/field-mappings
PUT
/v1/ads/forms/{formId}/field-mappings
const url = 'https://seu-endereco-da-api/v1/ads/forms/example/field-mappings';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"mappings":[{"questionKey":"example","fieldKey":"example","tagId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","fillOnlyEmpty":true}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://seu-endereco-da-api/v1/ads/forms/example/field-mappings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "mappings": [ { "questionKey": "example", "fieldKey": "example", "tagId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fillOnlyEmpty": true } ] }'Permissão que a Chave de acesso precisa: Gerenciar Meta Ads (ads:manage).
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Path Parameters
Seção intitulada “Path Parameters”formId
required
string
Request Bodyrequired
Seção intitulada “Request Bodyrequired”Media typeapplication/json
object
mappings
required
Array<object>
object
questionKey
required
string
fieldKey
string
tagId
string format: uuid
fillOnlyEmpty
boolean
Example generated
{ "mappings": [ { "questionKey": "example", "fieldKey": "example", "tagId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fillOnlyEmpty": true } ]}Responses
Seção intitulada “Responses”Media typeapplication/json
object
formId
required
string
mappings
required
Array<object>
object
questionKey
required
string
fieldKey
required
Campo do contato que recebe a resposta
string
tagId
required
Etiqueta aplicada a quem responde a pergunta
string
fillOnlyEmpty
required
Verdadeiro: só preenche o campo quando ele está vazio; falso: atualiza sempre
boolean
Example generated
{ "formId": "example", "mappings": [ { "questionKey": "example", "fieldKey": "example", "tagId": "example", "fillOnlyEmpty": true } ]}