Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

getList Custom LinksgetGet Custom LinkpostCreate Custom LinkputUpdate Custom LinkdelDelete Custom Link

Email Marketing

Knowledge

Support

Projects

Custom Links

Update Custom Link

Updates a custom contact link's label or URL template. Only the fields present in the body are written. The template is stored in two forms. Send urlHTML and urlJSON together when changing the URL, since the server does not derive one from the other.

PUT
/projects/{projectId}/crm/custom-contact-links/{customContactLinkId}

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the link.

customContactLinkIdrequiredstring

ID of the custom link to update.

Request Body

application/json

labelstring

Text shown for the link on the contact page.

urlHTMLstring

The URL template rendered as HTML. Update alongside urlJSON. The two are the same template in different forms and are not derived from each other.

urlJSONobject

The URL template as editor document JSON, holding the contact-property placeholders that get substituted per contact.

contentarray<object>
attrsobject
contentarray<object>
attrsobject
contentarray<object>
marksarray<object>
attrsobject
typerequiredstring
textstring
typerequiredstring
marksarray<object>
textstring
typerequiredstring
typerequiredstring

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://www.saasco.com/api/v2/projects/string/crm/custom-contact-links/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "projectId": "string",
  "label": "string",
  "urlJSON": {
    "content": [
      {
        "attrs": {
          "property1": null,
          "property2": null
        },
        "content": [
          {
            "attrs": {
              "property1": null,
              "property2": null
            },
            "content": [],
            "marks": [
              {
                "attrs": {
                  "property1": null,
                  "property2": null
                },
                "type": "string"
              }
            ],
            "text": "string",
            "type": "string"
          }
        ],
        "marks": [
          {
            "attrs": {
              "property1": null,
              "property2": null
            },
            "type": "string"
          }
        ],
        "text": "string",
        "type": "string"
      }
    ],
    "type": "doc"
  },
  "urlHTML": "string"
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Create Custom Link

Creates a custom contact link: a templated URL shown on every contact page, with contact properties substituted in. Use it to jump straight from a contact to that same person in another system, for example a Stripe customer or an internal admin page.

Delete Custom Link

Deletes a custom contact link, removing it from every contact page in the project. Contacts and their properties are unaffected. Cannot be undone.