Skip to main content
POST
/
shareholders
/
{shareholderId}
/
relations
/
{relationId}
/
promote
Promote a shareholder relation
curl --request POST \
  --url https://api.syntage.com/shareholders/{shareholderId}/relations/{relationId}/promote \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "JUAN MANUEL PEREZ GONZALEZ",
  "rfc": "PEIC211118IS0",
  "datasources": [
    {
      "name": "sat"
    },
    {
      "name": "rpc"
    }
  ]
}
'
{
  "@type": "ShareholderPromotedResponse",
  "id": "91ab5678-1234-5678-9abc-def012345678",
  "name": "JUAN MANUEL PEREZ GONZALEZ",
  "rfc": "PEIC211118IS0",
  "onboardingUrl": "https://api.syntage.com/onboarding/91ab5678-1234-5678-9abc-def012345678"
}

Authorizations

​
X-API-Key
string
header
required

Your API key is available in the Production and Sandbox dashboards.

Path Parameters

​
shareholderId
string<uuid>
required

The shareholder ID

​
relationId
string<uuid>
required

The relation ID

Body

application/json
​
name
string
required

The name of the shareholder to be promoted

Example:

"JUAN MANUEL PEREZ GONZALEZ"

​
rfc
string
required

RFC (Registro Federal de Contribuyentes)

Required string length: 12 - 13
Example:

"PEIC211118IS0"

​
datasources
object[]

Array of datasource configurations for the promoted shareholder

Example:
[{ "name": "sat" }, { "name": "rpc" }]

Response

Shareholder Relation promoted successfully

​
@type
string
default:ShareholderPromotedResponse
​
id
string<uuid>

The UUID of the created entity

Example:

"91ab5678-1234-5678-9abc-def012345678"

​
name
string

The name of the promoted shareholder

Example:

"JUAN MANUEL PEREZ GONZALEZ"

​
rfc
string

RFC (Registro Federal de Contribuyentes)

Required string length: 12 - 13
Example:

"PEIC211118IS0"

​
onboardingUrl
string | null

Optional onboarding URL for the promoted entity

Example:

"https://api.syntage.com/onboarding/91ab5678-1234-5678-9abc-def012345678"