Create a new builder


Create a new builder for your customers.

After creating a builder, you will get the URL link for that builder. this URL can be used by your customers to login, if you wish to share the access with them.

you can always login to that builder using the "login to a builder" api endpoint.


Settings:

URL

https://partners.99digital.co.il/api/builder/createBuilder

Method

JSON via POST

Header

Authorization: Bearer {{access_token}}

*The access_token can be received from settings->get access token API.


Body:

Parameter

Description / Example

Maximum length

Mandatory

client_name

A client name for you reference

100

Yes

reference

Any reference value (text/numbers only) you wish to receive back on the webhook. this is for your use only so you can recognize your client

50

no


Response:

{
"status": "OK",
"builderID": 432,
"client_name": "Mr. James",
"url": "https://builder...",
"reason": 1
}


Response-Explain:

Parameter

Description

status

OK or FAIL

"OK" means the request has been sent to Meta.

"Fail" means error.

builderID

The builderID that was automatically assigned to the builder

client_name

The client name you provided

url

The builder URL

reason

'reason' is the status explanation in case of FAIL

1

not FAIL. the status is OK

2

Wrong credentials

3

Access token does not exist or expired, please generate another one from Settings - Get access token API

13

you need to use POST method.

20

reference is invalid

30

client_name is invalid

31

Error on creating a builder, please try again or contact support