WhatsApp Cloud API · error code

WhatsApp error 1752041: Duplicate Request

Permanent - do not retryHTTP 400Onboarding, migration & partner setup

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
Duplicate Request is thrown when a client has already been invited to onboard by any partner.

What error 1752041 means

Code 1752041 is a Marketing Messages API for WhatsApp onboarding error returned with HTTP 400. It means a partner has already submitted the onboarding request for this business customer, whether that partner is you or someone else.

Meta allows one onboarding request per business customer, and only the first partner to call the intent API can submit it successfully. When the client is onboarded, all of their eligible WhatsApp Business Accounts are included automatically. Meta's reference spells out the consequence: if you receive this error, no further action is required, because every eligible account for that client will be onboarded without additional steps.

So treat 1752041 as "already in progress", not as a failure. What remains for the client is accepting the MM API terms of service in WhatsApp Manager if they have not done so yet; until then their eligible accounts are not onboarded.

What it looks like

{
  "error": {
    "message": "(#1752041) Duplicate Request",
    "type": "OAuthException",
    "code": 1752041,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Duplicate Request is thrown when a client has already been invited to onboard by any partner."
    },
    "fbtrace_id": "AtG7hJ9kL1zX3cV"
  }
}

Why it happens

  • Your onboarding job ran twice for the same business.
  • Another partner working with the same business already called the intent API.
  • Calling the intent API once per WABA, when one request already covers every eligible account of the client.

How to fix WhatsApp error 1752041

  1. 1Stop retrying; the request will keep returning 1752041.
  2. 2Mark the client as onboarding-requested in your system.
  3. 3Ask the client to accept the MM API terms in WhatsApp Manager if they have not yet done so.
  4. 4Watch for the account_update webhook with event MM_LITE_TERMS_SIGNED, sent per Messaging account once terms are signed.

How to stop it recurring

Call the intent API once per business, not once per WABA, and record the call before making it so a crash cannot cause a duplicate. Map 1752041 to a success-like state in your onboarding pipeline and drive the next step from the terms-signed webhook.

Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.

Related codes

Error 1752041 - quick answers

What does WhatsApp error 1752041 mean?

Code 1752041 is a Marketing Messages API for WhatsApp onboarding error returned with HTTP 400. It means a partner has already submitted the onboarding request for this business customer, whether that partner is you or someone else. Meta allows one onboarding request per business customer, and only the first partner to call the intent API can submit it successfully.

How do I fix WhatsApp error 1752041?

1. Stop retrying; the request will keep returning 1752041. 2. Mark the client as onboarding-requested in your system. 3. Ask the client to accept the MM API terms in WhatsApp Manager if they have not yet done so. 4. Watch for the account_update webhook with event MM_LITE_TERMS_SIGNED , sent per Messaging account once terms are signed.

Should I retry after error 1752041?

No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.

Stop debugging WhatsApp by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.