VAMOSIGNGratis, på alle planer

API og MCP for e-signering: send fra ditt eget system

Kort svar: lag en API-nøkkel under Utviklere i VAMOSIGN og kall ti handlinger over REST eller MCP. Systemet ditt, et skript eller en AI-assistent sender forespørselen, de som skal signere får lenkene sine på e-post, og en webhook sier fra til systemet ditt når et dokument er signert og forseglet. Ingen SDK: det er vanlig REST og Model Context Protocol. Å sende ett dokument og sjekke status virker på alle planer.

Steg for steg

Et eksempel: et saksbehandlingssystem som sender et oppdragsbrev når en sak åpnes.

DuVAMOSIGNDe som signerer, og andre
  1. 1
    Én gang · Du

    Du åpner Utviklere i VAMOSIGN og lager en API-nøkkel for arbeidsområdet.

  2. 2
    Én gang · Du

    Du legger til en webhook: en adresse i systemet ditt og hendelsene du vil ha, for eksempel document.sealed.

  3. 3
    Saken åpnes · Systemet ditt

    Systemet ditt kaller send_for_signature med dokumentet, en tittel og dem som skal signere. Over REST eller som et MCP-verktøy er det samme handling.

    POST https://app.vamosign.com/v1/send_for_signature
    Authorization: Bearer <API-nøkkelen din>
    Content-Type: application/json
    
    {
      "title": "Oppdragsbrev",
      "document_base64": "…",
      "signers": [{"name": "Kari Nordmann", "email": "kari@example.com"}]
    }
    
  4. 4
    Samme sekund · VAMOSIGN

    VAMOSIGN svarer med forespørselens id og sender hver som skal signere, sin lenke på e-post.

  5. 5
    Senere · De som signerer

    De signerer i nettleseren, som ved enhver forespørsel.

  6. 6
    Hver signatur · VAMOSIGN

    VAMOSIGN poster signature.completed til webhooken din. Innholdet er signert med HMAC-SHA256 i headeren X-Signer-Signature, så systemet ditt kan sjekke at det kom fra VAMOSIGN.

  7. 7
    Når alt er signert · VAMOSIGN

    VAMOSIGN poster document.sealed. Systemet ditt kaller check_status med id-en for å lese hvem som signerte og når.

    GET https://app.vamosign.com/v1/check_status?id=…
    Authorization: Bearer <API-nøkkelen din>
    
    {
      "id": "…",
      "status": "completed",
      "sealed": true,
      "signers": [
        {"name": "Kari Nordmann", "email": "kari@example.com", "status": "signed", "signed_at": "2026-09-29T12:15:00+02:00"}
      ]
    }
    
  8. 8
    Når som helst · Du

    Under Utviklere ser du hver webhook-levering, også dem som feilet.

Alle argumentene

Hvert kall trenger to headere: arbeidsområdets API-nøkkel som bearer-token, og Content-Type: application/json. MCP-verktøyene tar de samme argumentene, med de samme navnene.

OpenAPI: https://app.vamosign.com/openapi.json

POST https://app.vamosign.com/v1/send_for_signature

Sender ett dokument til én eller flere personer. Oppgi en mal eller en PDF.

titlestringpåkrevd
Navnet på dokumentet. De som signerer, ser det.
messagestring
En beskjed til dem som signerer. VAMOSIGN setter den i invitasjonen.
templatestring
Navnet eller sluggen til en mal. VAMOSIGN sender den gjeldende versjonen.
document_base64string
PDF-en, base64-kodet. Bruk denne når du ikke oppgir en mal.
filenamestring
Navnet på filen. Utelater du det, blir det dokument.pdf.
order"parallel" | "sequential"
parallel: VAMOSIGN spør alle samtidig. Dette er standard. sequential: VAMOSIGN spør dem i den rekkefølgen du lister dem, og skriver til hver person når den forrige har signert.
sign_bystring
Den siste dagen lenken kan signeres, som ÅÅÅÅ-MM-DD. Etter den dagen kan ingen signere, og du kan flytte datoen. Lar du den stå tom, er lenken åpen til alle har signert.
expires_onstring
Datoen avtalen løper ut, som ÅÅÅÅ-MM-DD.
expires_after_monthsinteger
Avtalen løper ut så mange måneder etter siste signatur, fra 1 til 120. Gi denne eller expires_on, ikke begge. Utelatt med en mal, gjelder malens egne måneder.
send_nowtrue | false
Sett den til false, så beholder VAMOSIGN et utkast som en person sender fra Dokumenter. Utelater du den, sender VAMOSIGN med en gang.
questionsarray
Det signatarene må svare på idet de signerer, ett objekt for hvert spørsmål. Krever Team. Malens egne spørsmål blir også stilt.
promptstringpåkrevd
Spørsmålet, slik signataren leser det.
shape"short_text" | "long_text" | "one_of" | "several_of" | "yes_no" | "number" | "date"
Hvordan signataren svarer. Utelater du det, blir det short_text.
requiredtrue | false
Sett den til false, så kan signataren la spørsmålet stå tomt. Utelater du den, må signataren svare før signering.
optionsarray
Valgene, for one_of og several_of.
whostring
E-postadressen til den ene signataren som blir spurt. Utelater du den, spør VAMOSIGN alle.
redact_after_weeksinteger
Uker etter at personen signerer, før VAMOSIGN fjerner svaret. Svaret tømmes, dokumentet forsegles på nytt med svaret merket som fjernet, og du får beskjed. 1 eller flere. Utelater du den, blir svaret stående i dokumentet. På Team og over.
signersarraypåkrevd
De som skal signere, ett objekt for hver:
namestring
Navnet på personen. Utelater du det, bruker VAMOSIGN delen av adressen foran @.
emailstringpåkrevd
Dit VAMOSIGN sender lenken. VAMOSIGN hopper over en person uten gyldig adresse.
phonestring
Et mobilnummer med landkode, for eksempel +47. Fra Starter og oppover sender VAMOSIGN lenken på SMS også.
sign_method"simple" | "selfie"
simple: personen skriver navnet sitt. Dette er standard. selfie: personen tar et bilde av seg selv på signeringssiden.
localestring
Språket VAMOSIGN skriver til denne personen på: en, nb, es. Utelater du det, bruker VAMOSIGN arbeidsområdets språk.
companyobject
Utelatt signerer personen som privatperson. Oppgitt er det selskapet de signerer for: name, org_number, country (to bokstaver, som NO) og, for et norsk selskap, check: signatur eller prokura. Med check leser VAMOSIGN fra Brønnøysundregistrene hvem som kan signere for selskapet, og sertifikatet viser hva registeret sa da dokumentet ble forseglet.

Du får tilbake: id, ref, title, status, state, sha256, expires_on, expires_after_months, sign_by, sealed og signers. Hver signatar har name, email, method, wave, status, signed_at og answers. Der avtalen løper ut et antall måneder etter siste signatur, fylles expires_on inn når dokumentet forsegles.

POST https://app.vamosign.com/v1/bulk_send

Sender det samme dokumentet til en liste med personer. Krever Team.

templatestring
Navnet eller sluggen til en mal. VAMOSIGN sender den gjeldende versjonen.
document_base64string
PDF-en, base64-kodet. Bruk denne når du ikke oppgir en mal.
filenamestring
Navnet på filen. Utelater du det, blir det dokument.pdf.
mode"separate" | "shared"
separate: hver person signerer sitt eget eksemplar, og hvert eksemplar får sitt eget signeringsbevis. Dette er standard. shared: alle signerer ett dokument.
recipientsarraypåkrevd
De dokumentet går til, ett objekt for hver:
namestring
Navnet på personen. Utelater du det, bruker VAMOSIGN delen av adressen foran @.
emailstringpåkrevd
Dit VAMOSIGN sender lenken. VAMOSIGN hopper over en person uten gyldig adresse.
phonestring
Et mobilnummer med landkode, for eksempel +47. Fra Starter og oppover sender VAMOSIGN lenken på SMS også.
sign_method"simple" | "selfie"
simple: personen skriver navnet sitt. Dette er standard. selfie: personen tar et bilde av seg selv på signeringssiden.
common_signersarray
Personer som signerer hvert eksemplar, etter mottakeren. Ett objekt for hver. Den som laget API-nøkkelen, signerer sist.
namestring
Navnet på personen. Utelater du det, bruker VAMOSIGN delen av adressen foran @.
emailstringpåkrevd
Dit VAMOSIGN sender lenken. VAMOSIGN hopper over en person uten gyldig adresse.

Du får tilbake: batch, som er utsendingens referanse, og requests, med én rad per forespørsel, lik den send_for_signature gir tilbake.

GET https://app.vamosign.com/v1/check_status

Forteller hvor én forespørsel står, hvem som har signert, og alt som har skjedd med den. Dette er en GET, så argumentet står i adressen.

request_idstringpåkrevd
Id-en som send_for_signature ga tilbake. Du kan også kalle den id.

Du får tilbake: Alt send_for_signature gir tilbake, og events. Hver hendelse har at, action, actor og ip. Hvert svar i answers har question og answer.

POST https://app.vamosign.com/v1/request_new_version

Ber alle som signerte en tidligere versjon av en mal, om å signere den gjeldende. Hver person får sin egen forespørsel. Krever Team.

templatestringpåkrevd
Navnet eller sluggen til malen.

Du får tilbake: template og requests, med én rad per forespørsel.

POST https://app.vamosign.com/v1/add_signer

Legger én person til et utkast eller en forespørsel som er sendt. Der alle blir spurt samtidig, skriver VAMOSIGN til den nye personen med en gang. Der folk blir spurt i rekkefølge, signerer den nye personen sist. Et selskap oppgis når forespørselen lages, ikke her.

request_idstringpåkrevd
Id-en som send_for_signature ga tilbake.
namestring
Navnet på personen. Hvis du utelater det, bruker VAMOSIGN delen av adressen før @.
emailstringpåkrevd
Hvor VAMOSIGN sender lenken. En adresse som allerede står på forespørselen, blir avvist.
phonestring
Et mobilnummer med landskode, for eksempel +47. På Starter og oppover sender VAMOSIGN lenken også på SMS.
sign_method"simple" | "selfie"
simple: personen skriver navnet sitt. Dette er standard. selfie: personen tar et bilde av seg selv på signeringssiden.
localestring
Språket VAMOSIGN skriver til denne personen på: en, nb, es. Hvis du utelater det, bruker VAMOSIGN språket til arbeidsområdet ditt.

Du får tilbake: Forespørselen slik send_for_signature gir den tilbake, med den nye personen i signers.

POST https://app.vamosign.com/v1/send_reminder

Sender invitasjonen på nytt til alle som har tur til å signere. Personen som laget API-nøkkelen, blir aldri påminnet.

request_idstringpåkrevd
Id-en som send_for_signature ga tilbake.

Du får tilbake: Forespørselen slik send_for_signature gir den tilbake, og reminded: hvor mange VAMOSIGN skrev til.

POST https://app.vamosign.com/v1/cancel_request

Trekker tilbake en forespørsel som ikke er ferdig. Ingen kan signere den etterpå. En forespørsel alle har signert, blir stående som den er.

request_idstringpåkrevd
Id-en som send_for_signature ga tilbake.

Du får tilbake: Forespørselen slik send_for_signature gir den tilbake, med status cancelled.

GET https://app.vamosign.com/v1/get_document

Gir deg en lenke til filen: den forseglede PDF-en når alle har signert, originalen før det. Lenken virker i ti minutter og trenger ingen nøkkel. Dette er en GET, så legg argumentet i adressen.

request_idstringpåkrevd
Id-en som send_for_signature ga tilbake.

Du får tilbake: id, ref, sealed, filename, content_type, bytes, sha256, url og expires_at. sha256 er sjekksummen til filen lenken gir deg.

GET https://app.vamosign.com/v1/get_evidence

Gir deg alt VAMOSIGN har registrert om én forespørsel som ett JSON-dokument, til å oppbevare ved siden av den signerte filen: sjekksummene, registreringskoden, hver signatar med metode, tidspunkt, IP-adresse og nettleser, svarene deres og hele hendelsesloggen. Dette er en GET, så legg argumentet i adressen.

request_idstringpåkrevd
Id-en som send_for_signature ga tilbake.

Du får tilbake: evidence (navnet på formatet, vamosign-evidence-v1), generated_at, request, document, record, signers og events.

Når VAMOSIGN avviser et REST-kall, svarer det 422 og en feilkode: no_signers, no_document, unknown_template, unknown_who, not_found, already_ended, not_out, link_closed, not_editable, already_on_request, purged, reminded_recently eller sending_paused. På en plan som ikke har handlingen, er koden tier_required, sammen med planen som har den og adressen til plansiden. En nøkkel som mangler eller er trukket tilbake, får 401.