Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0    Statistic    FMM    Blog  


Add a section to a multipart/formdata HTTP POST.

Component Version macOS Windows Linux Server FileMaker iOS SDK
CURL 2.6 Yes Yes Yes Yes Yes
MBS( "CURL.FormAddKeyText"; curl; name; filename; text { ; Encoding; ContentType; ContentHeaders } )   More


Parameter Description Example Flags
curl The CURL session handle. $curl
name The name of the form field. "city"
filename The file name for this file. "test.txt"
text The text for the text file. "Hello World"
Encoding The text encoding.
Default is native until version 10.1, UTF-8 from 10.2 on.
Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ.
UTF8 Optional
ContentType Available in MBS FileMaker Plugin 10.3 or newer.
The content type for this file.
"text/plain" Optional
ContentHeaders Available in MBS FileMaker Plugin 10.3 or newer.
List of headers to include.
"Content-Id: 12345" Optional


Returns "OK" or error code.


Add a section to a multipart/formdata HTTP POST.
This adds simply text file field with a given name and value.

Please call CURL.FormFinish after you added all your fields and before you call CURL.Perform.


Add a text file to form:

MBS("CURL.FormAddKeyText"; $curl; "Attachment"; "test.txt"; "Hello World"; "UTF-8")

Add SOAP request with MTOM attachment:

Set Variable [ $result ; Value: MBS("CURL.FormAddKeyText"; $curl; "request"; "<soap:Envelope><soap:Body><tns:data><xop:include href=\"test.txt\"/></tns:data></soap:Body> </soap:Envelope>"; "text/xml") ]
Set Variable [ $result ; Value: MBS("CURL.FormAddKeyText"; $curl; "test"; "A text attachment with ID 1234."; "text/plain"; "Content-Id: 1234") ]
Set Variable [ $result ; Value: MBS("CURL.FormFinish"; $curl) ]

See also

Blog Entries

Release notes

Created 18th August 2014, last changed 14th May 2020

CURL.FormAddKeyFileContentType   -   CURL.FormAddKeyTextContentType

Feedback: Report problem or ask question.

MBS FileMaker tutorial videos

Start Chat