AT&T DevEx

Alliance-aiab

Version v1 (latest)

Create Customer Account

Version v1
download iconDownload spec

Endpoint

POST
https://att-endcustomerlookup-eapi.gw.cloud.att.com/api/v1/customerAccount

The purpose of this API endpoint is to create a new end customer account in CIMs if no Account match found.

arrowRequest

Header Parameters

            Body Parameters

            Responses

            arrowBody

            application/json

            REQUEST

            1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
            curl --request POST \
     --url https://att-endcustomerlookup-eapi.gw.cloud.att.com/api/v1/customerAccount \
     --header 'accept: application/json' \
     --header 'client_id: string' \
     --header 'client_secret: string' \
     --header 'content-type: application/json' \
     --header 'source: string' \
     --header 'x-trace-id: string' \
     --header 'x-transaction-id: string' \
     --data '
{
  "country": "US",
  "name": "Acme Corp",
  "street1": "123 Main St",
  "street2": "Suite 400",
  "city": "Plano",
  "state": "TX",
  "postCode": "75075",
  "accountSourceCode": "SRC001",
  "locationName": "Headquarters",
  "phoneNumber": "7703316389",
  "dunsSiteId": "123456789",
  "mobilitySubSegment": "MID MARKETS MOBILITY 1",
  "attuid": "ab1234",
  "idPosition": "1",
  "channelInd": "Y",
  "svid": "SVID123",
  "svidName": "Some SVID Name",
  "complexProductInd": "N",
  "numberOfEmployees": 250
}
'

            RESPONSE

            1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
            {
  "status": 200,
  "timestamp": "2026-03-31T12:34:56Z",
  "responseData": [
    {
      "userFriendlyCoID": "CO-00012345",
      "id": "0011U00000H7K7wQAF",
      "href": "https://example.com/organizations/0011U00000H7K7wQAF",
      "isHeadOffice": true,
      "name": "Acme Corp",
      "contactMedium": [
        {
          "type": "phone",
          "value": "7703316389"
        }
      ],
      "organizationIdentification": [
        {
          "idType": "DUNS",
          "idValue": "123456789"
        }
      ],
      "status": "ACTIVE",
      "@type": "Organization"
    }
  ]
}